What is Synetic?

Tech Stack

Repositories

All repos are hosted on Gitea under the synetic org. Frontend repos are single-file SPAs with no build step.

Key Files You'll Touch

Live Platform Status

Real-time status from the API health endpoint and service checks.

Day 1 Checklist

Conventions

Useful Commands

Agent Chat Flow

The complete request lifecycle from user message to streamed response, including guardrail checks.

Tech Stack

Technologies powering the Synetic platform.

Environment Details

Development environment URLs, services, and connection information.

Application URLs

Service Configuration

Database

Authentication

Your Expertise. Always On.

Synetic is a platform for building AI agents trained on your knowledge, expertise, and intellectual property. It lets authors, consultants, advisors, and domain experts monetize what they know — 24/7, at scale, without adding anything to their calendar.

The Opportunity

Who It's For

How It Works

Platform Capabilities

Everything the platform provides to agent owners and their users.

Business Model

Repository Map

How I Work

What I Built

A non-exhaustive list of systems I designed and implemented for the Synetic platform.

Memory System

Capabilities

How to Work With Me

Platform Stats

Numbers from the current codebase.

Stack Overview

Tenants → Agents → Subscribers

Tenant (tenants table)
 ├── tenant_type: personal | business | education
 ├── config: allowed_domain, max_active_agents, status
 │
 ├── Tenant Members (tenant_members table)
 │    └── role: admin | member
 │
 └── Agents (agents table, FK: agents.tenant_id)
      │
      ├── Agent Managers (subscribers with is_admin=true)
      │    └── Can configure the agent but not delete it
      │
      └── Subscribers (subscribers table, FK: subscribers.agent_id)
           └── tier: free | practitioner | enterprise

Tenant Types

Every tenant has a type that controls provisioning rules, access restrictions, and available features.

User Roles

There are five distinct roles across the platform. Each role has specific access and capabilities.

Database Tables

Key tables that implement the role and permission model.

Feature Gating (3 Layers)

Features pass through three independent gates before being enabled for a subscriber.

Access Control Flow

How the platform determines what a user can do.

Naming Conventions

Critical naming to understand when reading the codebase.

Server Roles

The Synetic platform runs on a single server with two logical roles. All repos live under /var/www/.

Step 1: Prerequisites

Before starting, ensure the following are available.

Step 2: Install System Dependencies

# Update system
sudo apt update && sudo apt upgrade -y

# Install Python, nginx, certbot, and build tools
sudo apt install -y python3.12 python3.12-venv python3-pip nginx certbot python3-certbot-nginx git curl

# Install NLP dependencies (for content intelligence)
sudo apt install -y build-essential python3-dev

Step 3: Clone Repositories

Clone all 6 repos into /var/www/. Replace GITEA_URL with your Gitea instance.

cd /var/www

# Core repos
git clone $GITEA_URL/synetic/synetic-platform.git
git clone $GITEA_URL/synetic/synetic-marketing.git
git clone $GITEA_URL/synetic/synetic-portal.git
git clone $GITEA_URL/synetic/synetic-admin.git
git clone $GITEA_URL/synetic/synetic-agents.git
git clone $GITEA_URL/synetic/synetic-devportal.git

Step 4: Configure the API

Create the environment file from the template and fill in your credentials.

cd /var/www/synetic-platform/api
cp .env.example .env
nano .env

Required environment variables:

Step 5: Set Up Python Environment

cd /var/www/synetic-platform/api

# Create virtual environment
python3.12 -m venv venv

# Activate and install dependencies
source venv/bin/activate
pip install -r requirements.txt

# Download NLP models (for content intelligence)
python -m spacy download en_core_web_sm

The API will auto-initialize the database schema on first startup (via _init_db() in app.py). No manual migration scripts needed.

Step 6: Create the API Service

sudo nano /etc/systemd/system/synetic-api.service

Contents:

[Unit]
Description=Synetic Platform API
After=network.target

[Service]
User=root
WorkingDirectory=/var/www/synetic-platform/api
ExecStart=/var/www/synetic-platform/api/venv/bin/gunicorn \
    --workers 3 \
    --bind 127.0.0.1:5002 \
    --timeout 120 \
    --keep-alive 5 \
    --forwarded-allow-ips=127.0.0.1 \
    app:app
Restart=always
RestartSec=5
Environment=PATH=/var/www/synetic-platform/api/venv/bin

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable synetic-api
sudo systemctl start synetic-api

Step 7: Configure nginx

Create a server block for each subdomain. All follow the same pattern: serve static files, proxy /api/ to the Flask backend.

# Example: /etc/nginx/sites-available/portal.dev.synetic.io
server {
    server_name portal.dev.synetic.io;

    location / {
        root  /var/www/synetic-portal;
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        proxy_pass         http://127.0.0.1:5002;
        proxy_set_header   Host              $host;
        proxy_set_header   X-Real-IP         $remote_addr;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_buffering    off;
        proxy_read_timeout 120s;
        client_max_body_size 10m;
    }

    listen 80;
}

# Create sites for each domain
for site in dev.synetic.io portal.dev.synetic.io manage.dev.synetic.io agents.dev.synetic.io developers.dev.synetic.io; do
    sudo ln -sf /etc/nginx/sites-available/$site /etc/nginx/sites-enabled/
done

# Test and reload
sudo nginx -t && sudo systemctl reload nginx

# Set up HTTPS with Let's Encrypt
sudo certbot --nginx -d dev.synetic.io -d portal.dev.synetic.io -d manage.dev.synetic.io -d agents.dev.synetic.io -d developers.dev.synetic.io

Step 8: Deploy Code Updates

Use the synetic.sh management script for all deployments.

cd /var/www/synetic-platform

# Full deploy (pulls all repos, installs deps, restarts API, reloads nginx)
bash synetic.sh deploy

# Or manage individual services
bash synetic.sh restart    # Restart API + reload nginx
bash synetic.sh status     # Check all services
bash synetic.sh logs       # Tail API logs
bash synetic.sh health     # Health check all endpoints

Manual deploy (individual repo):

# Frontend repos (no restart needed, nginx serves static files)
cd /var/www/synetic-portal && git pull

# API repo (requires restart)
cd /var/www/synetic-platform && git pull
sudo systemctl restart synetic-api

Step 9: Verify Installation

# Check API is running
curl -s http://127.0.0.1:5002/api/health

# Check all services
bash synetic.sh status

# Check all endpoints are accessible
bash synetic.sh health

The API auto-initializes the database on first startup. All tables are created via _init_db() with idempotent CREATE TABLE IF NOT EXISTS statements. Default data (tenant types, feature metadata, guardrails) is seeded automatically.

Key Files Reference

Logo & Design Element

The Synetic logo consists of the design element mark paired with the wordmark. The design element also serves as the standalone favicon and icon representation across all products.

Full Logo (Dark Background)

Synetic

EXPERT AGENTS

Design Element (Standalone / Favicon)

64px

32px

16px

Logo Specifications

Contextual Logo Subtitles

The tagline below "Synetic" changes per product surface. The design element and wordmark remain consistent. The subtitle always uses the same typographic treatment.

Color System

All Synetic products use a dark theme with indigo/purple accent gradients. These are the core CSS custom properties used across every surface.

Backgrounds

Brand / Accent

Text

Status / Semantic

Borders & Surfaces

Typography

Two font families are used across all Synetic products. Both are loaded from Google Fonts.

Type Scale

Spacing & Border Radius

Button Styles

All buttons use DM Sans 600 weight. Consistent padding, border radius, and transition behavior across all surfaces.

Copy & Content Rules

Consistent rules across all marketing copy, UI text, and product surfaces.

Product Naming & Legal

Asset Files

All logo and icon assets available across the platform.

synetic-logo-mark.png

Design element mark (trimmed, transparent)

favicon.png

64x64 favicon (all sites)

synetic-design-element.png

Original full-size design element (source)