HubLensAI Agentsvercel-labs/open-agents
vercel-labs

open-agents

AIAI AgentsNext.jsVercelGitHub APIAutomation
View on GitHub
93
+340

// summary

Open Agents is an open-source reference application designed for building and running background coding agents on the Vercel platform. The system utilizes a three-layer architecture that separates the web interface, durable agent workflows, and isolated sandbox execution environments. This modular design allows developers to perform complex coding tasks, such as repository management and automated pull requests, without requiring active local machine involvement.

// technical analysis

Open Agents is a reference architecture designed to facilitate the creation and execution of background coding agents by decoupling the agent's control plane from the execution sandbox. By utilizing a three-layer system—web interface, durable workflow runtime, and isolated sandbox VM—the project ensures that agent execution is not tied to a single request lifecycle, allowing for long-running, asynchronous coding tasks. This architectural separation enables the sandbox to hibernate and resume independently, providing a robust environment for file manipulation, shell commands, and git operations without requiring the user's local machine to remain active.

// key highlights

01
Implements a durable workflow runtime that allows multi-step agent execution to persist across sessions.
02
Provides isolated Vercel-based sandboxes that support snapshot-based resuming and independent hibernation.
03
Features a chat-driven interface that integrates file, search, shell, and web tools for autonomous coding tasks.
04
Supports seamless GitHub integration, enabling the agent to clone repositories, push branches, and create pull requests automatically.
05
Offers session sharing capabilities via read-only links to facilitate collaboration on agent-generated work.
06
Includes optional voice-to-text transcription powered by ElevenLabs for hands-free interaction.

// use cases

01
Chat-driven coding assistance with file, shell, and web tool integration
02
Durable multi-step workflow execution with automated task cancellation and streaming
03
Isolated sandbox environments with snapshot-based resume and GitHub repository synchronization

// getting started

To begin, fork the repository and deploy it to Vercel, ensuring you configure the required PostgreSQL database and generate the necessary JWE and encryption secrets. For full functionality, create and link a Vercel OAuth app and a GitHub App to enable repository access and authentication. Developers can also run the project locally by installing dependencies with 'bun install', configuring the environment variables in 'apps/web/.env', and executing 'bun run web'.