{"id":50270353,"url":"https://github.com/openhands/agent-canvas","last_synced_at":"2026-06-12T01:01:41.731Z","repository":{"id":353475173,"uuid":"1219543409","full_name":"OpenHands/agent-canvas","owner":"OpenHands","description":"OpenHands Agent Canvas is a self-hostable AI coding platform. Start locally, connect your tools, and automate workflows.","archived":false,"fork":false,"pushed_at":"2026-05-20T20:37:15.000Z","size":61257,"stargazers_count":10,"open_issues_count":106,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-20T21:38:37.404Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://agent-server-gui.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenHands.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-24T01:31:56.000Z","updated_at":"2026-05-20T20:37:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/OpenHands/agent-canvas","commit_stats":null,"previous_names":["neubig/agent-server-gui","openhands/agent-server-gui","openhands/agent-canvas"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/OpenHands/agent-canvas","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenHands%2Fagent-canvas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenHands%2Fagent-canvas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenHands%2Fagent-canvas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenHands%2Fagent-canvas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenHands","download_url":"https://codeload.github.com/OpenHands/agent-canvas/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenHands%2Fagent-canvas/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33575520,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-27T17:01:20.017Z","updated_at":"2026-06-12T01:01:41.575Z","avatar_url":"https://github.com/OpenHands.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agent-canvas\n\n\u003e [!WARNING]\n\u003e This project is in the **Beta** phase. It may be vibecoded, untested, or out of date. OpenHands takes no responsibility for the code or its support. [Learn more](https://github.com/OpenHands/incubator-program).\n\n[![Project Status: Beta](https://img.shields.io/badge/status-beta-blue)](https://github.com/OpenHands/incubator-program)\n\nOpenHands is a platform for orchestrating coding agents across different environments. You can:\n\n- ⌨️ prompt agents manually\n- 🕐 run agents on a schedule\n- ⚡ trigger agents automatically — e.g. from Slack, GitHub, or Datadog.\n\nAgents can run anywhere:\n\n- 🧑‍💻 on your laptop\n- 🖥️ on a remote virtual machine\n- ☁️ in our hosted cloud\n- 🏢 or inside your company’s infrastructure\n\nThe same Agent Canvas frontend can swap between each of these environments, so you can see everything in one place.\n\nOpenHands works with any agent harness (e.g. Claude Code, Codex)\nor connect directly to an LLM (e.g. Anthropic, OpenAI, Gemini, Mistral, Minimax, Kimi).\n\nIf you have questions or feedback, please open a GitHub issue or join the [#proj-agent-canvas channel in Slack](https://openhands.dev/joinslack).\n\n\u003cimg width=\"1509\" height=\"826\" alt=\"Screenshot 2026-05-11 at 10 13 19 AM\" src=\"https://github.com/user-attachments/assets/71ef41ae-8f6d-4fbf-990f-d672175d93d1\" /\u003e\n\n## Project ownership and support\n\n- **Current status**: Beta.\n- **Support channel**: [#proj-agent-canvas](https://openhands.dev/joinslack).\n- **Support level**: Best effort while the project remains in Beta.\n\n## Quickstart\n\nYou can install OpenHands to run agents on any machine: on your laptop, on a dedicated computer like a Mac Mini,\nor on a server in the cloud.\n\nThe most powerful way to run OpenHands is on a server in the cloud. This allows your agents to continue running\neven when your laptop is shut, and makes it easier to trigger your agents through third-party services\nlike Slack, GitHub, and Datadog. See [SELF_HOSTING.md](docs/SELF_HOSTING.md) for details, especially with respect to security hardening.\n\nNotably, you can run the backend in _multiple different environments_, and switch between\nthem from the same Agent Canvas frontend. E.g. you can share an Agent Server with your team for agents doing\ncode review and dependency updates, then have your personal agents running on your laptop.\n\n### Option 1: Without a Sandbox\n\n\u003e [!WARNING]\n\u003e This runs the agent-server directly on the machine you're installing on — the agent will have full access to your filesystem!\n\n**Prerequisites**: Node.js 22.12.x or later, `uv`\n\n```sh\nnpm install -g @openhands/agent-canvas\nagent-canvas\n```\n\nThe `agent-canvas` command starts the full local stack by default. You can also split it when you want to run pieces separately:\n\n```sh\nagent-canvas --frontend-only  # static frontend + ingress only\nagent-canvas --backend-only   # agent server + automation backend + ingress only\n```\n\n### Option 2: With a Docker Sandbox\n\n**Prerequisites**:\n\n- Docker: Docker Desktop on macOS/Windows, or Docker Engine/Docker Desktop on Linux.\n- A host directory for `PROJECTS_PATH` containing the project folders you want the agent to access. Create it before starting the container.\n\n**macOS / Linux:**\n\n```sh\nexport PROJECTS_PATH=\"$HOME/projects\"  # directory containing your project folders\nmkdir -p \"$PROJECTS_PATH\" \"$HOME/.openhands\"\n\ndocker run -it --rm \\\n  -p 8000:8000 \\\n  -v \"$HOME/.openhands:/home/openhands/.openhands\" \\\n  -v \"${PROJECTS_PATH}:/projects\" \\\n  ghcr.io/openhands/agent-canvas:1.0.0-rc.6\n```\n\n**Windows (PowerShell / Windows Terminal):** See [README.windows.md](./README.windows.md) for the equivalent commands.\n\nThe agent will be able to access any project under `PROJECTS_PATH`.\n\n### Option 3: From Source\n\n\u003e [!WARNING]\n\u003e This runs the agent-server directly on the machine you're installing on — the agent will have full access to your filesystem!\n\n**Prerequisites**: Node.js 22.12.x or later, `npm`, `uv` (for running the agent server via `uvx`)\n\n```sh\ngit clone https://github.com/OpenHands/agent-canvas.git\ncd agent-canvas\nnpm install\nnpm run dev\n```\n\n---\n\nAccess the UI at [http://localhost:8000](http://localhost:8000). You can add additional backends directly from the UI.\n\n# Architecture\n\nAgent Canvas is powered by the [OpenHands Agent Server](https://github.com/OpenHands/software-agent-sdk/tree/main/openhands-agent-server/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.\n\nYou can run an Agent Server anywhere:\n\n- Directly on your laptop (be careful!)\n- On a dedicated machine like a Mac Mini\n- On a virtual machine in the cloud\n- Inside OpenHands Cloud (our commercial offering)\n\nThe Agent Server is often paired with an [Automation Server](https://github.com/OpenHands/automation), which lets you set up agents that run on a schedule or in response to events.\n\n\u003cimg width=\"1456\" height=\"1258\" alt=\"image\" src=\"https://github.com/user-attachments/assets/cb6de6f5-ac30-4d04-a76a-b5c259f0c163\" /\u003e\n\n## More documentation\n\n- [Documentation index](./docs/README.md)\n- [Architecture overview](./docs/architecture.md)\n- [Development guide](./docs/DEVELOPMENT.md)\n- [Self-hosting guide](./docs/SELF_HOSTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenhands%2Fagent-canvas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenhands%2Fagent-canvas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenhands%2Fagent-canvas/lists"}