Practical overview
When it fits
Use Agent Foundation when an agent project needs more than a model call: managed execution, memory, sandboxing, configurable integrations or recovery for durable workflows. Harness UI is the documented entry point for interactive exploration before building an application.
Who it is for
- Developers building AI agent applications
- Teams needing a self-hosted agent runtime
- Individuals exploring agent configurations through a terminal or browser workbench
Documented uses
- Deploy managed AI agents in a self-hosted service
- Add persistent memory to agent applications
- Run computer-use work inside sandboxed environments
- Support durable, long-running agent workflows
- Connect models, web-data services and remote MCP servers
Requirements & limits
The documented Service setup runs with Docker Compose and requires Docker with Docker Compose plus either a model-provider API key or an eligible ChatGPT plan. The first launch creates the administrator account; additional users join through administrator invitations.
- Service, Harness and Harness UI serve different roles: managed deployment, embedded runtime extension and interactive exploration.
- The documented implementation uses Python and requires Python 3.13+ for the repository tooling, while the Compose path does not require a source checkout, Make, Python or Node.js.
- Execution environments include Docker and listed hosted sandbox providers; the Local directory environment is available only in development.
- The stack includes PostgreSQL and Redis and accesses the host Docker Engine for agent execution.
- The project is in active 0.x development, so minor releases may change APIs and configuration.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Start the self-hosted Service with Docker Compose
Launch the documented Service stack and create a first agent.
Before you start
- Docker with Docker Compose
- A model provider API key or an eligible ChatGPT plan
- The published Compose file
Steps
Download the a13n Service Compose file and start it with Docker Compose.
Open http://127.0.0.1:8080 in a browser.
Register the first administrator account with an email address and a password of at least 8 characters.
Under Models, add a provider using an API key or Sign in with ChatGPT, then select a model.
Create an agent and send a first message with Try agent.
Expected outcome
A local Service deployment with an administrator, connected model and agent available for an initial interaction.
Guide limitations
- The project is in active 0.x development, so APIs and configuration may change between minor releases.
- The Compose setup mounts the host Docker socket and binds to loopback; consult the deployment guide before exposing Service to other machines.
- The source Compose file uses the published latest image, while release assets pin a release version.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 3 October 2026
- Original website title
- converge-ai-labs/agent-foundation · Official homepage title · retained in its source language

