{"id":37067322,"url":"https://github.com/seer-engg/seer","last_synced_at":"2026-01-14T07:54:06.691Z","repository":{"id":323719477,"uuid":"1076233968","full_name":"seer-engg/seer","owner":"seer-engg","description":"AI workflows","archived":false,"fork":false,"pushed_at":"2026-01-11T19:40:54.000Z","size":4984,"stargazers_count":23,"open_issues_count":5,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-11T21:51:28.908Z","etag":null,"topics":["ai-agents","aiworkflow"],"latest_commit_sha":null,"homepage":"https://getseer.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seer-engg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-14T15:23:21.000Z","updated_at":"2026-01-10T02:48:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/seer-engg/seer","commit_stats":null,"previous_names":["seer-engg/seer"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/seer-engg/seer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seer-engg%2Fseer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seer-engg%2Fseer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seer-engg%2Fseer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seer-engg%2Fseer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seer-engg","download_url":"https://codeload.github.com/seer-engg/seer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seer-engg%2Fseer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28413522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T05:26:33.345Z","status":"ssl_error","status_checked_at":"2026-01-14T05:21:57.251Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","aiworkflow"],"created_at":"2026-01-14T07:54:06.124Z","updated_at":"2026-01-14T07:54:06.680Z","avatar_url":"https://github.com/seer-engg.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Seer\n\nSeer is a **workflow builder with fine-grained control** for creating and executing automated workflows with integrated tools and services. Build complex automation workflows with visual editing, AI-assisted development, and seamless integrations (Google Workspace, GitHub, and more).\n\n### Core Architecture Principle\n\n**If workflows and agents are fundamentally different at the UI layer, they should be different at the API layer.**\n\nThis principle guides our API design: workflows (deterministic, node-based execution) and agents (dynamic, message-based conversations) have distinct mental models, data structures, and user needs. Rather than forcing unification through pattern matching or transformation layers, we maintain separate APIs and components that align with their fundamental differences. This reduces complexity, improves maintainability, and ensures each system can evolve independently.\n\n### Quick Start\n\n```bash\ngit clone \u003crepo\u003e \u0026\u0026 cd seer\ndocker compose up\n```\n\nThat's it! Starts Docker services (Postgres, Redis, backend, worker), streams logs, and waits for readiness.\n\n### Deploy to Railway\n\nDeploy Seer to Railway with one click:\n\n[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/[TEMPLATE-ID])\n\n**What gets deployed:** FastAPI backend, background worker, PostgreSQL, and Redis\n\n**Setup:** Click button, enter `OPENAI_API_KEY`, wait 5-7 minutes. Estimated cost: $15-30/month.\n\nFor detailed deployment instructions, see [Railway Deployment Guide](./docs/deployment/RAILWAY.md).\n\n### Using the Workflow Editor\n\nAfter running `docker compose up`, the workflow editor is available at:\n- **Frontend**: http://localhost:5173/workflows?backend=http://localhost:8000\n- **Backend API**: http://localhost:8000\n\n### Configuration\n\nCreate a `.env` file:\n\n```bash\n# Required\nOPENAI_API_KEY=sk-...\n\n# Optional integrations (add as needed)\nGOOGLE_CLIENT_ID=...\nGOOGLE_CLIENT_SECRET=...\nTAVILY_API_KEY=...\n```\n\nDocker automatically configures `DATABASE_URL` and `REDIS_URL`.\n\nFor complete configuration options, see [Configuration Reference](./docs/advanced/CONFIGURATION.md).\n\n### Usage\n\n**Start development environment:**\n```bash\ndocker compose up\n```\n\n**View logs:**\n```bash\ndocker compose logs -f\n```\n\n**Stop services:**\n```bash\ndocker compose down\n```\n\n### Development Workflow\n\n**Steps:**\n1. Run: `docker compose up`\n2. Code changes hot-reload via volume mounts (uvicorn --reload)\n3. Access workflow builder at: http://localhost:5173/workflows?backend=http://localhost:8000\n4. View logs in the terminal or run: `docker compose logs -f`\n5. Stop: `docker compose down`\n\n**Services started:**\n- **Backend API** (port 8000): FastAPI server with workflow execution engine\n- **Postgres** (port 5432): Workflow and user data persistence\n- **Redis** (port 6379): Taskiq message broker\n- **Taskiq Worker**: run `uv run taskiq worker worker.broker:broker` (or use Docker) to process triggers/polling/workflow runs\n\n### Integrations \u0026 API Keys\n\n**Core Requirements:**\n- `OPENAI_API_KEY` or `ANTHROPIC_API_KEY` - Required for workflow execution and AI assistance\n\n**Optional Integrations:**\n- **Google Workspace** - `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` (Gmail, Drive, Sheets)\n- **GitHub** - `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET` (Repos, Issues, PRs)\n- **Supabase** - `SUPABASE_CLIENT_ID`, `SUPABASE_CLIENT_SECRET` ([Setup Guide](./docs/integrations/SUPABASE.md))\n- **Web Search** - `TAVILY_API_KEY`\n\nFor complete configuration options, see [Configuration Reference](./docs/advanced/CONFIGURATION.md).\n\n### Key Features\n\n**🛠️ Visual Workflow Builder**\n- Drag-and-drop interface for creating automation workflows\n- Node-based editor with custom blocks and integrations\n- Real-time workflow validation and execution\n\n**🤖 AI-Assisted Development**\n- Chat interface for workflow design and debugging\n- AI suggestions for workflow improvements\n- Intelligent error handling and recovery\n\n**🔗 Rich Integrations**\n- **Google Workspace**: Gmail, Drive, Sheets with OAuth\n- **GitHub**: Repository management, issues, PRs\n- **Web Tools**: Search, content fetching, APIs\n- **Databases**: PostgreSQL with approval-based write controls\n\n**⚡ Advanced Execution Engine**\n- Streaming execution with real-time updates\n- Interrupt handling for human-in-the-loop workflows\n- Persistent state management with PostgreSQL\n\n**🔒 Enterprise-Ready**\n- Self-hosted or cloud deployment options\n- OAuth-based authentication (Clerk integration)\n- Role-based access control\n- Audit trails and execution history\n\n### Documentation\n\n- [Quick Start](#quick-start) - Get running in 60 seconds\n- [Railway Deployment](./docs/deployment/RAILWAY.md) - Production deployment guide\n- [Worker Setup](./worker/README.md) - Background task worker configuration\n- [Integrations](./docs/integrations/SUPABASE.md) - Google, GitHub, Supabase setup\n- [Advanced Features](./docs/advanced/) - Triggers, proposals, and more\n- [Configuration Reference](./docs/advanced/CONFIGURATION.md) - Complete configuration options\n- [Complete Documentation](./docs/) - Full documentation index\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseer-engg%2Fseer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseer-engg%2Fseer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseer-engg%2Fseer/lists"}