Getting started

Three commands to a running install

git clone https://github.com/sky-cloak/gaby
cd gaby

make install            # backend + web + Slack MCP deps
make env                # creates ops/docker/.env (edit ANTHROPIC_API_KEY)
make up                 # docker compose up -d → backend:8080 web:8090 redis

Open http://localhost:8090. Watch backend logs for the bootstrap URL (make logs or make bootstrap-token) to create the admin account.

Two-terminal local dev

make dev-backend        # terminal 1 (Python, uv, port 8080)
make dev-web            # terminal 2 (Vite, port 5173, proxies /api)

Optional profiles

make up-graph           # + Postgres+AGE for graph-native memory
make up-slack           # + @gaby/mcp-slack inbound ticket source
make up-all             # both

See ops/docker/.env.example for every env var Gaby reads.

First run checklist

1. Bootstrap — admin account + ANTHROPIC_API_KEY reminder + telemetry opt-in.
2. Onboarding — use case, help desk, history replay, knowledge, systems, escalation.
3. Connect a ticket source at /connectors (Slack/Zoho/email).
4. Connect at least one system so the agent has something to investigate against (Postgres/Keycloak/Redis/Sentry/Stripe).
5. Upload knowledge at Settings → Knowledge (markdown, PDFs, anything cite-able).

After step 5, send a test ticket through your help desk; Gaby polls, investigates, and either auto-resolves or escalates per autonomy settings.

Running tests

make test               # full pyramid: backend + web + contract + Slack MCP
make lint               # ruff + mypy + biome + tsc
make release-gate       # dry-run release gate (eval + live-test check)