Seer is a open-source workflow builder with built-in oversight and cost controls for creating and executing automated workflows with integrated tools and services.

1. Clone and start the stack (Postgres, Valkey, API, worker):

git clone https://github.com/seer-engg/seer
cd seer
docker compose up

2. Run database migrations:

docker compose exec api uv run aerich upgrade

3. Access the app:

• Cloud Frontend (Default): Visit http://localhost:8000 → redirects to https://app.getseer.dev
• Local Frontend: Set FRONTEND_URL=http://localhost:5173 in .env file
• API Docs: http://localhost:8000/docs
• Backend Health: http://localhost:8000/health

Your browser will automatically open and connect the cloud frontend to your local backend. Sign in with Clerk to start using Seer.

• Prereqs: Python 3.12+, uv installed (pip install uv), Postgres + Valkey running (use docker compose up postgres valkey).
• Install deps: uv sync
• Run API: uv run uvicorn seer.api.main:app --reload --port 8000
• Run worker: uv run taskiq worker seer.worker.broker:broker
• Run tests: uv run pytest

• src/seer/api/ – FastAPI routers, middleware, API models (workflows, tools, integrations, triggers, agents).
• src/seer/services/ – business logic used by API/worker (workflow execution, triggers, integrations).
• src/seer/core/ – workflow compiler/runtime, schema models, global compiler singleton.
• src/seer/tools/ – tool registry, executor, credential resolver, provider implementations; src/seer/tool_hub/ for tool index/search.
• src/seer/worker/ – Taskiq worker, background tasks, trigger polling.
• src/seer/agents/ – agent orchestration (LangGraph-based workflow agent).
• src/seer/database/ – Tortoise ORM models/config; migrations live in /migrations.
• src/seer/analytics/, src/seer/observability/, src/seer/utilities/ – shared instrumentation and helpers.
• documentation/ – docs site assets; scripts/ – maintenance helpers; tests/ – automated tests.

Create a .env file:

# Required
OPENAI_API_KEY=sk-...

# Optional integrations (add as needed)
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...
TAVILY_API_KEY=...

Docker automatically configures DATABASE_URL and REDIS_URL.

Helpful commands:

• Start everything: docker compose up
• Follow logs: docker compose logs -f
• Stop services: docker compose down
• Run API locally: uv run uvicorn seer.api.main:app --reload --port 8000
• Run worker locally: uv run taskiq worker seer.worker.broker:broker
• Tests: uv run pytest

Migrations do NOT run automatically. Run them manually when pulling new code.

After pulling latest changes:

docker compose exec api uv run aerich upgrade

Migrations run automatically before deployment via Railway's preDeployCommand. No manual action needed for production.

If not using Docker, run migrations directly:

uv run aerich upgrade

🛠️ Visual Workflow Builder

• Drag-and-drop interface for creating automation workflows
• Visual editor with custom blocks and integrations
• Real-time workflow validation and execution

💰 Cost Governance

• Built-in spend caps and token limits per workflow
• Budget controls to prevent runaway AI expenses
• Transparent cost tracking and reporting
• Per-workflow and account-level spending limits

👁️ Execution Transparency

• Complete run history for every workflow execution
• Detailed tracing with timing and outputs
• Human oversight checkpoints for critical decisions
• Audit trails and execution logs

🤖 AI-Assisted Automation

• Chat interface for workflow design and debugging
• AI suggestions for workflow improvements
• Intelligent error handling and recovery

🔗 Rich Integrations

• Google Workspace: Gmail, Drive, Sheets with minimal permissions
• GitHub: Repository management, issues, PRs
• Web Tools: Search, content fetching, APIs
• Databases: PostgreSQL with approval-based write controls

🔒 Self-Hostable

• Self-hosted or cloud deployment options
• Minimal permissions approach (read-only first)
• OAuth-based authentication (Clerk integration)
• Role-based access control

📚 Complete Documentation - Full docs site with guides, API reference, and examples

• Quick Start - Get running in 60 seconds
• Architecture - Backend overview and concepts
• Worker Setup - Background task worker configuration
• Integrations - Google, GitHub, Supabase setup
• Advanced Features - Triggers, proposals, and more
• Configuration Reference - Complete configuration options

Seer is open source under the MIT license. Enterprise features (if any exist) reside in the ee/ directory and are licensed separately. See LICENSE for details.