OpenHands
OpenHands Agent Canvas is a self-hosted developer control center for running and managing coding agents and automations. It solves the problem of coordinating multiple agents across local, remote, and cloud backends, and is for developers who want to automate tasks like report generation and issue decomposition.
🎬 OpenHands CLI + Gemini 2.5 Pro : This IS A REALLY AWESOME Alternative to CLAUDE CODE! · AICodeKing
✨ Key features
- Self-host agents locally, in Docker, on VMs, or cloud
- Switch between local, remote, and cloud agent backends
- Create automations integrated with Slack, GitHub, Linear
- Run automations on schedules or via webhook events
- Bring your own LLM model
- Use with OpenHands, Claude Code, Codex, Gemini, or ACP agents
🎯 Use cases
- Generate reports that publish to Slack automatically
- Decompose GitHub issues into tasks automatically
- Run coding agents on a schedule or in response to events
- Manage multiple agents across different environments from one UI
📦 Installation
🧰 Requirements: Requires Node.js 22.12.x or later and uv for local install; Docker for sandboxed install; optional cloud accounts for remote backends.
Option 1: Without a Sandbox
Prerequisites: Node.js 22.12.x or later, uv
npm install -g @openhands/agent-canvas
agent-canvas
Option 2: With a Docker Sandbox
Prerequisites: Docker, and a host directory for PROJECTS_PATH.
macOS / Linux:
export PROJECTS_PATH="$HOME/projects"
mkdir -p "$PROJECTS_PATH" "$HOME/.openhands"
docker run -it --rm \
-p 8000:8000 \
-v "$HOME/.openhands:/home/openhands/.openhands" \
-v "${PROJECTS_PATH}:/projects" \
ghcr.io/openhands/agent-canvas:1.16.0
Option 3: From Source
Prerequisites: Node.js 22.12.x or later, npm, uv
git clone https://github.com/OpenHands/OpenHands.git
cd OpenHands
npm install
npm run dev
🚀 Usage
After installation, access the UI at http://localhost:8000 (npm/source) or http://localhost:8000/canvas (Docker). You can add additional backends directly from the UI.
⚠️ Good to know
Running without a sandbox gives the agent full access to your filesystem; Docker sandbox limits access to projects under PROJECTS_PATH.
❓ FAQ
What are the prerequisites for installing without a sandbox?
You need Node.js 22.12.x or later and uv.
Can I use agents other than OpenHands?
Yes, you can use any ACP-compatible agent like Claude Code, Codex, or Gemini.
How do I run agents in a Docker sandbox?
Use the provided docker run command with a host directory for PROJECTS_PATH and mount it to /projects.
Where can I access the UI after starting?
For npm/source launchers, go to http://localhost:8000; for Docker, go to http://localhost:8000/canvas.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.