GitHub - vercel-labs/open-agents: An open source template for building cloud agents.
6 hours ago
- #Vercel
- #coding-agents
- #open-source
- Open Agents is an open-source reference app for building background coding agents on Vercel, featuring web UI, agent runtime, sandbox orchestration, and GitHub integration.
- The system has a three-layer architecture: Web (handles auth, sessions, chat UI), Agent workflow (runs as a durable workflow), and Sandbox VM (execution environment for filesystem, shell, git).
- Agent execution is separate from the sandbox, allowing independent lifecycle management, model/provider evolution, and the sandbox to remain a plain execution environment.
- Key features include chat-driven coding with tools (file, search, shell), durable multi-step execution, isolated Vercel sandboxes with snapshot resume, repo cloning, auto-commit/push/PR, session sharing, and optional voice input.
- Deployment requires environment variables like POSTGRES_URL, JWE_SECRET, and optional ones for Vercel OAuth, GitHub integration, Redis/KV, sandbox snapshot, and ElevenLabs API.
- Setup involves forking the repo, creating a PostgreSQL database, generating secrets, importing to Vercel, adding env vars, deploying, and configuring Vercel OAuth and GitHub App with specific callback URLs.
- Local development uses commands like 'bun run web' and requires filling in env values in apps/web/.env, with guidance for setting up Vercel OAuth and GitHub App locally.