otter
Run with Docker

Self-host

No GitHub clone required. Pull the public image, start Compose (local Postgres + Redis auto-created), then Connect GitHub via the Otter GitHub App.

Run

Or: docker compose -f https://otter-m21xlszi1-manas-projects-577f14e5.vercel.app/docker-compose.yml up -d

Then open http://127.0.0.1:3000/app. Image: manasdutta04/otter:latest.

Requirements

  • Docker Engine + Compose v2
  • Ollama on the host (recommended): ollama pull qwen2.5-coder:7b

Connect GitHub

Click Connect GitHub in the UI (or otter login). You install the Otter GitHub App — you do not paste Client secrets or create your own OAuth app. Details: GitHub docs.

CLI and MCP

Keep Docker running, then use the CLI/MCP against http://127.0.0.1:8000. The CLI does not embed a database — it uses the same local API + Postgres as the web UI.

otter login
otter repos list

# MCP (after otter login) — example env
# OTTER_API_URL=http://127.0.0.1:8000
# OTTER_SESSION is optional if ~/.otter/config.json exists

Open the product UI

  • Workspace: http://127.0.0.1:3000/app
  • Models: http://127.0.0.1:3000/app/models
  • API: http://127.0.0.1:8000

First-run checklist

  1. Compose up (DB created in Docker).
  2. Connect GitHub (Otter app).
  3. Open Models and select Local Ollama.
  4. Import a repository URL.