SETUP.md

Setup — Deploy with Docker (self-host)

Very short guide. Runs the browser + all 3 API servers on your own machine/server. Your login is saved automatically — no database needed for Docker.

1. Install Docker

• Docker Desktop (Mac/Windows) or docker + docker compose (Linux).
• Check: docker --version

2. Get the code

git clone https://huggingface.co/spaces/akash1313/selfapi-v2
cd selfapi-v2

3. Run it

docker compose up --build -d

• Open http://localhost:3001 → watch the browser.
• Log in to ChatGPT / Gemini / Flow once.

4. Stop / restart

docker compose down      # stops; login stays saved in the volume
docker compose up -d      # starts again; login is back

Your profile lives in the chrome-profile Docker volume, so logins survive restarts and reboots automatically. (To wipe it: docker compose down -v.)

---

Which file does what

File	Job
docker-compose.yml	Runs everything (browser + 3 servers) + the save-login volume
Dockerfile	Builds the browser image
start_hf.sh	Boot steps (start Chrome + extensions)

---

Running on Hugging Face instead? (needs Neon)

HF free Spaces have no permanent disk, so there logins need a Postgres database.

1. Sign up free at neon.tech → create a project.
2. Copy the connection string (postgresql://user:pass@...neon.tech/db?sslmode=require).
3. In your Space → Settings → Variables and secrets → New secret:
   • Name: DATABASE_URL
   • Value: the connection string
4. The Space restarts → log in once → it auto-saves every 5 min and survives rebuilds.

Deploy code to HF with git push. Never commit the connection string.

---

Using the API

All three servers run inside the container; the monitor fronts them on one URL by path:

Service	Base path	Example
ChatGPT	/gpt/	POST /gpt/api/chat
Gemini	/gemini/	POST /gemini/chat
Flow	/flow/	POST /flow/generate/video

Set an API_KEY secret (HF: Settings → secret API_KEY; Docker: add to .env) — every API call must send it:

curl -X POST https://YOUR-SPACE.hf.space/gpt/api/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"hello"}'

Without the key the API returns 401/503. The monitor UI stays open (no key).