HubLensAI Agentsvercel-labs/open-agents
// archived 2026-04-17
vercel-labs

open-agents

AI#AI Agents#Next.js#Vercel#GitHub API#Automation
View on GitHub
84

// 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 modular reference application designed to facilitate the creation and execution of background coding agents on the Vercel platform. Its architecture employs a three-layer system that strictly separates the web interface, the durable agent workflow, and the isolated sandbox environment. This decoupling ensures that agent execution remains independent of request lifecycles and allows the sandbox to hibernate and resume without interrupting the control plane, providing a robust foundation for automated coding tasks.

// key highlights

01
Features a durable workflow engine that supports multi-step execution, streaming, and task cancellation.
02
Utilizes isolated Vercel sandboxes that support snapshot-based resuming and independent hibernation.
03
Integrates directly with GitHub to enable automated repository cloning, branch management, and pull request creation.
04
Provides a chat-driven interface equipped with specialized tools for file manipulation, shell commands, and web interaction.
05
Supports session sharing via read-only links and optional voice-to-text transcription using ElevenLabs.
06
Designed as a forkable reference implementation to allow developers to adapt the agent runtime and sandbox logic to their specific needs.

// 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 persistence and automated GitHub PR creation

// 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 local development, install dependencies using 'bun install', populate the 'apps/web/.env' file with your credentials, and execute 'bun run web' to launch the application. You can then configure Vercel OAuth and GitHub App integrations to enable full repository access and automated coding workflows.