Deployment Guide

HASSAR.AI consists of two independently deployed components that connect at runtime:

1. Log in to Cloudflare Dashboard → Workers & Pages
2. Click Create → Pages → Connect to Git
3. Authorise Cloudflare to access your GitHub account
4. Select repository: VlassStudio/HassarAI
5. Click Begin setup

Under Environment variables, add the following for both Production and Preview:

Click Save and Deploy. The first build takes 2–4 minutes.

1. In your Pages project → Custom domains → Set up a custom domain
2. Enter hassar.ai — Cloudflare auto-creates DNS records
3. Repeat for www.hassar.ai if needed
4. SSL is provisioned automatically — no further action needed

git clone https://github.com/VlassStudio/HassarAI.git
cd HassarAI/backend

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

sudo -u postgres psql

CREATE DATABASE hassarai;
CREATE USER hassarai_user WITH PASSWORD 'your-strong-password';
GRANT ALL PRIVILEGES ON DATABASE hassarai TO hassarai_user;
\q

Create /home/<user>/HassarAI/backend/.env:

DATABASE_URL=postgresql://hassarai_user:your-strong-password@localhost:5432/hassarai
JWT_SECRET_KEY=<random-string-minimum-64-characters>
APP_ENV=production

Create /etc/systemd/system/hassarai.service (replace <user> with your system username):

[Unit]
Description=HASSAR.AI Backend
After=network.target postgresql.service

[Service]
Type=simple
User=www-data
WorkingDirectory=/home/<user>/HassarAI/backend
EnvironmentFile=/home/<user>/HassarAI/backend/.env
ExecStart=/home/<user>/HassarAI/backend/venv/bin/uvicorn app.main:app --host 127.0.0.1 --port 8000 --workers 2
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable hassarai
sudo systemctl start hassarai
sudo systemctl status hassarai

sudo apt install nginx -y

Create /etc/nginx/sites-available/hassarai-api:

server {
    listen 80;
    server_name api.hassar.ai;

    location / {
        proxy_pass http://127.0.0.1:8000;
        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_set_header CF-Connecting-IP $http_cf_connecting_ip;
        proxy_read_timeout 120s;
    }
}

sudo ln -s /etc/nginx/sites-available/hassarai-api /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d api.hassar.ai

Follow the prompts. Certbot auto-renews every 90 days.

Verify Backend

curl https://api.hassar.ai/
# Expected: {"ok": true}

1. Open https://hassar.ai/signup and register the first user
2. Promote to admin directly in the database:

sudo -u postgres psql hassarai

UPDATE users SET role = 'admin' WHERE email = 'your@email.com';
\q

1. Log in to https://hassar.ai with your admin account
2. Go to System Admin → AI Config
3. Enter the AGIM URL and API Key provided by Vlass Studio
4. Click Save
5. Open Talk to Jim and send a test message — confirm AGIM responds