vercel-labs/open-agents là dự án tích hợp AI trên GitHub với 5.9k sao, viết chủ yếu bằng TypeScript. An open source template for building cloud agents.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
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
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/vercel-labs/open-agents là nguồn chính thức.
vercel-labs/open-agents có bao nhiêu sao?
vercel-labs/open-agents có 5.9k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/vercel-labs/open-agents. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
vercel-labs/open-agents có phải mã nguồn mở không?
Có — vercel-labs/open-agents phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/vercel-labs/open-agents.
vercel-labs/open-agents còn đang phát triển không?
Commit gần nhất trên vercel-labs/open-agents là 4 tháng trước (theo timestamp GitHub). Repo có 747 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
vercel-labs/open-agents là gì?
vercel-labs/open-agents (vercel-labs/open-agents) là dự án TypeScript trên GitHub. Theo mô tả gốc: An open source template for building cloud agents.
vercel-labs/open-agents so với các dự án AI Tools khác thế nào?
vercel-labs/open-agents được TopGit xếp vào nhóm AI Tools, với 5.9k sao GitHub và viết bằng TypeScript. Xem trang chủ đề AI Tools trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
Đọc đầy đủ README ở tab phía trên.
Vẫn đang phân vân về open-agents?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về open-agents.