Quickstart

Local run in five minutes.

1. Backend

pip install -r requirements.txt
cp .env.example .env
python -m openbotics.cli serve
# open http://127.0.0.1:8090

Without keys it runs in mock mode — the whole UI works, the model is simulated.

2. Admin account

Set OPENBOTICS_ADMIN_EMAIL / OPENBOTICS_ADMIN_PASSWORD in .env and restart. The server creates the admin on startup (password is hashed, never stored).

3. Model key

Get a key at opencode.ai/auth, paste it in Settings → Connect (admin), and the single Muse Spark model goes live on Zen + Go.

4. First bot & thread

Talk to the CEO, or create a specialist (Bots → New). Start a group thread, @mention a bot to route work to it directly.

5. Connect Gmail

Marketplace → Google → Manage → Authorize. One consent covers Gmail, Drive, and Calendar. Ask the CEO “what's in my inbox?” — real mail means you're live.

Desktop shell

cd electron && npm install
OPENBOTICS_URL=http://127.0.0.1:8090 npm start

Point OPENBOTICS_URL at your VPS to drive the hosted backend from the desktop app.