// 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
// use cases
// 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'.