OpenHands Agent Canvas

What it does

OpenHands Agent Canvas is a self-hosted control center for coding agents and automations. You start conversations or set up automations, such as reports that publish to Slack or GitHub issues split into tasks, and agents carry them out on your laptop, in Docker, on a server or in OpenHands Cloud. It runs the open source OpenHands agent and can also drive Claude Code, Codex, Gemini CLI or OpenCode. It suits developers and teams comfortable running their own tools.

It is free to self-host, works with any model, and lets one screen manage several agents and always-on automations.

Before you start

• 1A computer with macOS, Windows or Linux.
• 2An API key from the AI model provider you choose; OpenHands Cloud needs an OpenHands account
• 3Node.js 24 or later and uv, or Docker
• 4An API key for the AI model you want to use
• 5Without Docker, the agent can reach every file on your computer
• ✓Free option: Agent Canvas is free to self-host; you still pay your model provider
• !Pay per use. The AI service it calls charges for what you use.

How to start

1. Install itPaste the install request into an AI agent you already use, or run the official command yourself or follow the official guide.macOS, Windows, Linuxnpx @openhands/agent-canvasCopy

   Install command

   Your browser blocked copying. Select the text and copy it yourself.

   npx @openhands/agent-canvas

   This is the official install command, copied from the creator's instructions. Paste it where the instructions say.

   Close
   macOS, Windows, Linuxnpm install -g @openhands/agent-canvasCopy

   Install command

   Your browser blocked copying. Select the text and copy it yourself.

   npm install -g @openhands/agent-canvas

   This is the official install command, copied from the creator's instructions. Paste it where the instructions say.

   Close
   macOS, Linuxmkdir -p ~/projects docker run -it --rm \ -p 127.0.0.1:8000:8000 \ -v openhands-data:/home/openhands/.openhands \ -v ~/projects:/projects \ ghcr.io/openhands/agent-canvas:latestCopy

   Install command

   Your browser blocked copying. Select the text and copy it yourself.

   mkdir -p ~/projects docker run -it --rm \ -p 127.0.0.1:8000:8000 \ -v openhands-data:/home/openhands/.openhands \ -v ~/projects:/projects \ ghcr.io/openhands/agent-canvas:latest

   This is the official install command, copied from the creator's instructions. Paste it where the instructions say.

   Close
2. Sign up and choose a planCreate an account or sign in, then compare the official plans.
3. Give it a first taskDescribe what you want in your own words, and check the first result before relying on it.

Steps follow the creator's instructions.