
-
Run Polpo
- npx (recommended)
- npm
- pnpm
- Docker
No install needed. This launches the setup wizard and dashboard onhttp://localhost:3000. -
Setup wizard
If no config exists, Polpo opens the setup wizard automatically. It walks you through:
- Detect providers — scans your env for API keys and OAuth profiles
- Pick a model — shows recommended models from your detected providers
- Name your team — creates your first agent with a role
ANTHROPIC_API_KEY,OPENAI_API_KEY,GEMINI_API_KEY, etc.) or an OAuth login (polpo auth login). See Providers & Models for 22+ supported providers. - Start working You’re in the dashboard. Type what you need — “create a REST API”, “fix the bug in auth.ts”, “write tests for the user module” — hit Enter, and the agent does it.
Scale up
When you’re ready for more, Polpo orchestrates full teams of agents working in parallel with dependencies and automated quality checks:- Build Your Team — Add specialist agents, configure roles and models
- Your First Mission — Create multi-task missions with dependencies and automated assessment
- Talk from Anywhere — Control Polpo from Telegram, WhatsApp, Slack, or email
What happens under the hood
- Mission — AI generates tasks with dependencies and agent assignments
- Assign — The orchestrator assigns each task to the right agent, respecting dependencies
- Execute — Detached runner processes spawn agents with core tools (read, write, edit, bash, glob, grep, ls)
- Assess — Three LLM judges score each result on correctness, completeness, code quality, and edge cases
- Done — Tasks that pass move to
done. Tasks that fail get feedback and retry automatically
What’s next
Build Your Team
Add specialist agents, configure roles and constraints.
Your First Mission
Multi-task missions with dependencies and automated assessment.
Talk from Anywhere
Telegram, WhatsApp, Slack, email — talk to Polpo with the apps you already use.
Configuration
Fine-tune retries, quality thresholds, notifications, and provider settings.