Самостоятельно размещаемый центр управления разработчиком для агентов программирования и автоматизаций.

Запускайте OpenHands, Claude Code, Codex, Gemini или любой совместимый с ACP агент на локальных, удаленных и облачных бэкендах.

Быстрый старт | Документация | Самостоятельный запуск | ACP-агенты | Автоматизации | Slack

OpenHands Agent Canvas превращает ваших агентов программирования в самостоятельно размещаемую, постоянно работающую инженерную команду. Это центр управления разработчиком для начала диалогов и автоматизации повседневных задач — например, генерации отчетов, публикуемых в Slack, или автоматической декомпозиции задач из GitHub на подзадачи.

По умолчанию он запускается локально на вашей машине, но может подключаться к нескольким «бэкендам агентов», например, запускать агенты в контейнерах Docker, на виртуальных машинах или в инфраструктуре вашей компании. Вы также можете опционально выбрать запуск агентов на инфраструктуре OpenHands Cloud или OpenHands Enterprise.

Agent Canvas по умолчанию использует открытый исходный код агента OpenHands, но может работать с любыми сторонними агентами, такими как Claude Code и Codex.

Если у вас есть вопросы или отзывы, пожалуйста, создайте задачу в GitHub или присоединитесь к каналу #proj-agent-canvas в Slack.

[!NOTE] Код в этом репозитории перемещается! Смотрите Часто задаваемые вопросы по переходу Agent Canvas

Исходный код OpenHands Agent и Agent Server находится в OpenHands/software-agent-sdk.

Исходный код Agent Canvas находится в OpenHands/agent-canvas.

Быстрый старт

Вы можете установить OpenHands для запуска агентов на любой машине: на вашем ноутбуке, на выделенном компьютере, таком как Mac Mini, или на сервере в облаке.

Самый мощный способ запуска OpenHands — на сервере в облаке. Это позволяет вашим агентам продолжать работу даже при выключенном ноутбуке и упрощает вызов агентов через сторонние сервисы, такие как Slack, GitHub и Datadog. Подробности смотрите в руководстве по самостоятельному размещению, особенно в части укрепления безопасности.

Важно, что вы можете запускать бэкенд в нескольких различных средах и переключаться между ними из одного интерфейса Agent Canvas. Например, вы можете предоставить Agent Server вашей команде для агентов, выполняющих проверку кода и обновление зависимостей, а затем запустить личных агентов на вашем ноутбуке.

Вариант 1: Без песочницы

[!WARNING] Этот способ запускает agent-server непосредственно на машине, на которую вы его устанавливаете — агент будет иметь полный доступ к вашей файловой системе!

Предварительные требования: Node.js 22.12.x или новее, uv

npm install -g @openhands/agent-canvas
agent-canvas

Команда agent-canvas по умолчанию запускает полный локальный стек. Вы также можете разделить его, если хотите запускать компоненты отдельно:

agent-canvas --frontend-only  # только статический фронтенд + входная точка
agent-canvas --backend-only   # только сервер агентов + бэкенд автоматизации + входная точка

Вариант 2: С Docker-песочницей

Предварительные требования:

• Docker: Docker Desktop для macOS/Windows или Docker Engine/Docker Desktop для Linux.
• Хостовая директория для 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.0.0-rc.11

Windows (PowerShell / Windows Terminal): Смотрите README.windows.md для эквивалентных команд.

Агент сможет получить доступ к любому проекту в директории PROJECTS_PATH.

Вариант 3: Из исходного кода

[!WARNING] Этот способ запускает agent-server непосредственно на машине, на которую вы его устанавливаете — агент будет иметь полный доступ к вашей файловой системе!

Предварительные требования: Node.js 22.12.x или новее, npm, uv (для запуска сервера агентов через uvx)

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

Доступ к интерфейсу: http://localhost:8000. Вы можете добавлять дополнительные бэкенды непосредственно из интерфейса.

Архитектура

Agent Canvas работает на основе OpenHands Agent Server, REST API для запуска нескольких агентов на одной машине. Каждый Agent Server работает на одном хосте/порту; Agent Canvas может подключаться к нескольким Agent Server и легко переключаться между ними.

Вы можете запустить Agent Server где угодно:

• Непосредственно на вашем ноутбуке (будьте осторожны!)
• На выделенной машине, такой как Mac Mini
• На виртуальной машине в облаке
• Внутри OpenHands Cloud (наш коммерческий продукт)

Agent Server часто используется в паре с Automation Server, который позволяет настраивать агенты, работающие по расписанию или в ответ на события.

Дополнительная документация

• Индекс документации
• Обзор архитектуры
• Руководство для разработчиков
• Руководство по самостоятельному размещению