open-agents
An open source template for building cloud agents.
What is open-agents?
An open source template for building cloud agents.
Overview of open-agents
What it is
Open Agents is an open-source reference app for building and running background coding agents on Vercel. It includes a web UI, an agent runtime, sandbox orchestration, and GitHub integration. The repository is intended to be forked and adapted. The system has three layers: a web app (handling auth, sessions, chat, and streaming UI), an agent that runs as a durable workflow on Vercel, and a sandbox execution environment (filesystem, shell, git, dev servers, and preview ports). A key architectural decision is that the agent does not run inside the sandbox VM; it runs outside and interacts with it through tools like file reads, edits, search, and shell commands.
Key features
- Chat-driven coding agent with file, search, shell, task, skill, and web tools - Durable multi-step execution with Workflow SDK-backed runs, streaming, and cancellation - Isolated Vercel sandboxes with snapshot-based resume - Repo cloning and branch work inside the sandbox - Optional auto-commit, push, and PR creation after a successful run - Session sharing via read-only links - Optional voice input via ElevenLabs transcription
Use cases
- Running background coding agents that can make code changes without keeping a local machine involved - Building and testing agent workflows that interact with a sandboxed filesystem and shell - Experimenting with agent architectures where the agent and sandbox are separated - Automating GitHub workflows such as cloning repos, making changes, and creating pull requests
Getting started
To deploy on Vercel: 1. Fork the repository. 2. Import the repo into Vercel (Neon Postgres is auto-provisioned if using the deploy button). 3. Generate a secret: openssl rand -base64 32 for BETTER_AUTH_SECRET. 4. Add POSTGRES_URL and BETTER_AUTH_SECRET as environment variables in Vercel project settings. 5. Deploy once to get a stable production URL. 6. Create a Vercel OAuth app and add its client ID and secret. 7. Optionally create a GitHub App for full GitHub-enabled flow. For local setup: bash corepack enable pnpm install cp apps/web/.env.example apps/web/.env # fill in required values pnpm web
License and pricing
The license is MIT. The project is open source.
Based on the project's public README and repository metadata.