seermcp 0.1.4

Seer

Seer is a open-source workflow builder with fine-grained control for creating and executing automated workflows with integrated tools and services.

Quick Start (Docker)

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

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

2. Access the app:

• Frontend: http://localhost:5173/workflows?backend=http://localhost:8000
• Backend API: http://localhost:8000

Local Development (without full Docker)

• Prereqs: Python 3.12+, uv installed (pip install uv), Postgres + Redis running (use docker compose up postgres redis).
• 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

Project Layout (backend)

• 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.

Configuration

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

Key Features

🛠️ Visual Workflow Builder

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

🤖 AI-Assisted Development

• 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 OAuth
• GitHub: Repository management, issues, PRs
• Web Tools: Search, content fetching, APIs
• Databases: PostgreSQL with approval-based write controls

🔒 Enterprise-Ready

• Self-hosted or cloud deployment options
• OAuth-based authentication (Clerk integration)
• Role-based access control
• Audit trails and execution history

Documentation

📚 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

License

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.