open-agents
Applicationvercel-labs/open-agents
An open source template for building cloud agents on Vercel.
Overview
A reference application for building and running background coding agents on Vercel. Features a web UI, agent runtime, sandbox orchestration, and GitHub integration for prompt-to-code workflows.
README Preview
# Open Agents\n\n[](https://vercel.com/new/clone?project-name=open-agents&repository-name=open-agents&repository-url=https%3A%2F%2Fgithub.com%2Fvercel-labs%2Fopen-agents&demo-title=Open+Agents&demo-description=Open-source+reference+app+for+building+and+running+background+coding+agents+on+Vercel.&demo-url=https%3A%2F%2Fopen-agents.dev%2F&env=POSTGRES_URL%2CBETTER_AUTH_SECRET%2CNEXT_PUBLIC_VERCEL_APP_CLIENT_ID%2CVERCEL_APP_CLIENT_SECRET%2CNEXT_PUBLIC_GITHUB_CLIENT_ID%2CGITHUB_CLIENT_SECRET%2CGITHUB_APP_ID%2CGITHUB_APP_PRIVATE_KEY%2CNEXT_PUBLIC_GITHUB_APP_SLUG%2CGITHUB_WEBHOOK_SECRET&envDescription=Neon+can+provide+POSTGRES_URL+automatically.+Generate+BETTER_AUTH_SECRET+yourself%2C+then+add+your+Vercel+OAuth+and+GitHub+App+credentials+for+a+full+deployment.&products=%255B%257B%2522type%2522%253A%2522integration%2522%252C%2522protocol%2522%253A%2522storage%2522%252C%2522productSlug%2522%253A%2522neon%2522%252C%2522integrationSlug%2522%253A%2522neon%2522%257D%252C%257B%2522type%2522%253A%2522integration%2522%252C%2522protocol%2522%253A%2522storage%2522%252C%2522productSlug%2522%253A%2522upstash-kv%2522%252C%2522integrationSlug%2522%253A%2522upstash%2522%257D%255D&skippable-integrations=1)\n\nOpen Agents is an open-source reference app for building and running background coding agents on Vercel. It includes the web UI, the agent runtime, sandbox orchestration, and the GitHub integration needed to go from prompt to code changes without keeping your laptop involved.\n\nThe repo is meant to be forked and adapted, not treated as a black box.\n\n## What it is\n\nOpen Agents is a three-layer system:\n\n```text\nWeb -> Agent workflow -> Sandbox VM\n```\n\n- The web app handles auth, sessions, chat, and streaming UI.\n- The agent runs as a durable workflow on Vercel.\n- The sandbox is the execution environment: filesystem, shell, git, dev servers, and preview ports.\n\n### The key architectural decision: the agent is not the sandbox\n\nThe agent does not run inside the VM. It run
FAQ (2)
TroubleshootingWhy does my deployed Next.js app return a 404 error despite a successful build?
Troubleshooting
Why does my deployed Next.js app return a 404 error despite a successful build?In your deployment settings, select 'Next.js' from the framework dropdown. This configures the platform to handle Next.js routing and avoids 404s. Also, verify the Root Directory is set correctly (e.g., 'apps/web') and build-time env vars are present.
TroubleshootingHow to unlink a Vercel project after accidentally committing the .vercel/project.json file?
Troubleshooting
How to unlink a Vercel project after accidentally committing the .vercel/project.json file?Run vercel unlink in the project directory, then manually remove the .vercel/project.json file from your Git repository with git rm .vercel/project.json and commit the change.