An AI-powered entry in TopGit's GitHub warehouse: vercel-labs/open-agents, 5.9k stars, AI Tools, TypeScript. An open source template for building cloud agents.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Open 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.
The repo is meant to be forked and adapted, not treated as a black box.
What it is
Open Agents is a three-layer system:
Web -> Agent workflow -> Sandbox VM
The web app handles auth, sessions, chat, and streaming UI.
The agent runs as a durable workflow on Vercel.
The sandbox is the execution environment: filesystem, shell, git, dev servers, and preview ports.
The key architectural decision: the agent is not the sandbox
The agent does not run inside the VM. It runs outside the sandbox and interacts with it through tools like file reads, edits, search, and shell commands.
That separation is the main point of the project:
agent execution is not tied to a single request lifecycle
sandbox lifecycle can hibernate and resume independently
model/provider choices and sandbox implementation can evolve separately
the VM stays a plain execution environment instead of becoming the control plane
Current capabilities
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
Runtime notes
A few details that matter for understanding the current implementation:
Chat requests start a workflow run instead of executing the agent inline.
Each agent turn can continue across many persisted workflow steps.
Active runs can be resumed by reconnecting to the stream for the existing workflow.
Sandboxes expose ports 3000, 5173, 4321, and 8000, can optionally use a configured base snapshot, and hibernate after inactivity.
Auto-commit and auto-PR are supported, but they are preference-driven features, not always-on behavior.
Environment variables
See apps/web/.env.example for the full list. Summary:
REDIS_URL / KV_URL: optional skills metadata cache (falls back to in-memory when not configured).
OPEN_AGENTS_RESOURCE_PROFILE: optional deployment resource profile. Set to hobby to use Hobby-compatible defaults for chat and sandbox resources; leave unset for standard behavior.
VERCEL_PROJECT_PRODUCTION_URL / NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL: canonical production URL for metadata and some callback behavior.
VERCEL_SANDBOX_BASE_SNAPSHOT_ID: optional base snapshot for fresh sandboxes. If unset, sandboxes start from Vercel's standard Sandbox runtime. Use a snapshot created in/accessible to your own Vercel scope.
ELEVENLABS_API_KEY: voice transcription.
Deploy your own copy on Vercel
Fork this repo.
Import the repo into Vercel. Neon Postgres is auto-provisioned if you use the deploy button above.
use the GitHub App's Client ID and Client Secret for NEXT_PUBLIC_GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET
make the app public if you want org installs to work cleanly
Add the GitHub App env vars and redeploy.
Optionally add Redis/KV, OPEN_AGENTS_RESOURCE_PROFILE=hobby for Hobby-compatible resource defaults, the canonical production URL vars, and your own VERCEL_SANDBOX_BASE_SNAPSHOT_ID if you want fresh sandboxes to start from a preconfigured image.
Local setup
Install dependencies:
corepack enable
pnpm install
Create your local env file:
cp apps/web/.env.example apps/web/.env
Fill in the required values in apps/web/.env.
Start the app:
pnpm web
If you already have a linked Vercel project, you can pull env vars locally with vc env pull.
OAuth and integration setup
Vercel OAuth
Authentication is handled by Better Auth with Vercel and GitHub as social providers. All auth routes are served from the /api/auth/[...all] catchall.
You do not need a separate GitHub OAuth app. Open Agents uses the GitHub App's OAuth credentials as a Better Auth social provider, plus the App's installation tokens for repo access.
Create a GitHub App for installation-based repo access and configure:
make the app public if you want org installs to work cleanly
For local development, use http://localhost:3000 as the homepage URL, http://localhost:3000/api/auth/callback/github as the callback URL, and http://localhost:3000/api/github/app/callback as the setup URL.
GITHUB_APP_PRIVATE_KEY can be stored as the PEM contents with escaped newlines or as a base64-encoded PEM.
Useful commands
pnpm web # run dev server
pnpm check # lint + format check
pnpm fix # lint + format fix
pnpm typecheck # typecheck all packages
pnpm run ci # full CI: check, typecheck, tests, migration check
pnpm sandbox:snapshot-base # refresh sandbox base snapshot
How active is development on vercel-labs/open-agents?
The most recent commit recorded on vercel-labs/open-agents was 4 months ago, based on the GitHub push timestamp. The repository has 747 forks — one of the better signals of community interest.
How does vercel-labs/open-agents compare to other AI Tools projects?
vercel-labs/open-agents is tracked by TopGit in the AI Tools category, with 5.9k GitHub stars and written in TypeScript. Browse the AI Tools topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does vercel-labs/open-agents have?
vercel-labs/open-agents has 5.9k GitHub stars — refresh the page for the live number, or check github.com/vercel-labs/open-agents. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is vercel-labs/open-agents open source?
Yes — vercel-labs/open-agents ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/vercel-labs/open-agents.
What is vercel-labs/open-agents?
vercel-labs/open-agents (vercel-labs/open-agents) is a TypeScript project on GitHub. From the project's own README: An open source template for building cloud agents.
Where do I read more about vercel-labs/open-agents?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/vercel-labs/open-agents is the definitive source.
Read full README in the tab above.
Is open-agents worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of open-agents.