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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/vercel-labsopen-agents.svg)](https://yunodb.com/tools/vercel-labsopen-agents?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/vercel-labsopen-agents?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/vercel-labsopen-agents.svg" alt="Featured on YunoDB" height="20"></a>