agent-canvas

Warning

This project is in sandbox phase. It may be vibecoded, untested, or out of date. OpenHands takes no responsibility for the code or its support. Learn more.

Agent Canvas is a web frontend for managing agents. You can:

• ⌨️ prompt them manually
• 🕐 run them on a schedule
• ⚡ trigger them automatically—e.g. from Slack or GitHub.

Agents can run anywhere:

• 🧑‍💻 on your laptop
• 🖥️ on a remote virtual machine
• ☁️ in our hosted cloud
• 🏢 or inside your company’s infrastructure

You can work with any agent (e.g. Claude Code, Codex) or connect directly to an LLM (e.g. Anthropic, OpenAI, Gemini, Mistral, Minimax, Kimi).

If you have questions or feedback, please open a GitHub issue or join the #proj-agent-canvas channel in Slack

Quickstart

Prerequisites:

• Node.js 22.12.x or later
• npm
• uv (for running the agent server via uvx)

Warning

This runs the agent-server directly on the machine you're installing on--the agent will have full access to your filesystem! Stay tuned for docker sandboxing instructions.

git clone https://github.com/OpenHands/agent-canvas.git
cd agent-canvas
npm install
npm run dev

Access the UI at http://localhost:8000

Architecture

Agent Canvas is powered by the OpenHands Agent Server, a REST API for running multiple agents on a single machine. Each Agent Server runs on a single host/port; the Agent Canvas can connect to multiple Agent Servers and easily flip between them.

You can run an Agent Server anywhere:

• Directly on your laptop (be careful!)
• Inside a Docker container
• On a dedicated machine like a Mac Mini
• On a virtual machine in the cloud
• Inside a Kubernetes Pod
• Inside OpenHands Cloud (our commercial offering)

The Agent Server is often paired with an Automation Server, which lets you set up agents that run on a schedule or in response to events.

More documentation

For contributor and developer workflows, including frontend-only mode, mock mode, environment variables, and build/test commands, see DEVELOPMENT.md.