OpenHands — экосистема для разработки программ с ИИ-агентами. Агент получает задачу и рабочее окружение, изучает файлы проекта, меняет код и использует инструменты для проверки результата. Пользователь может наблюдать за работой, уточнять поручение и оценивать предложенные изменения.

Основной современный интерфейс называется Agent Canvas. Это центр управления разговорами, файлами, терминалами и автоматизацией в браузере. Сам агент выполняется в подключённой среде: на вашем компьютере, собственном сервере или в OpenHands Cloud. Выбор места запуска влияет на доступные файлы и расходы.

Какие задачи можно поручить агенту

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

Разобраться, какой участок кода отвечает за ошибочное поведение, и предложить исправление.
Подготовить изменения после обновления библиотеки и проверить совместимость.
Проанализировать правки и отметить возможные проблемы для ревью.
Выполнить повторяющееся поручение через настроенную автоматизацию.

Хорошее первое задание содержит пример: «При пустом поле поиска страница возвращает ошибку. Найди причину, сохрани нынешнее поведение непустых запросов и покажи проверку обоих случаев». Такой запрос задаёт границу изменения и позволяет отличить исправление от случайной переделки соседней функции.

Agent Canvas, Cloud и SDK: что выбрать

Для обычной работы с кодом начните с Agent Canvas. Интерфейс связывается со средой исполнения, где находятся инструменты и рабочие файлы. Локальный запуск подходит для своего проекта; Docker или удалённая среда позволяют организовать отдельное окружение.

OpenHands Cloud предоставляет управляемую инфраструктуру: пользователь работает с сервисом без самостоятельного обслуживания его серверной части. Разработчикам собственных интеграций предназначены Software Agent SDK и Agent Server с REST и WebSocket API. Это разные способы использовать экосистему, а не отдельные языковые модели.

Как начать работу с репозиторием

Выберите среду: установленный Agent Canvas с локальным окружением либо OpenHands Cloud через официальный сайт.
Подготовьте рабочую папку или репозиторий и настройте доступ агента к нему.
Подключите модель или поддерживаемый агентный движок. Для внешнего провайдера потребуются его учётные данные.
Укажите задачу, способ воспроизведения проблемы и ожидаемый результат. Сообщите, какими командами собирается и проверяется проект.
Просмотрите изменённые файлы и результаты проверок перед принятием работы.

Не каждая ошибка запуска означает проблему в сгенерированном коде: в окружении может отсутствовать зависимость или переменная настройки. Полезно попросить агента отдельно перечислить выполненные проверки и то, что он не смог проверить. Это делает результат понятным следующему разработчику.

Бесплатный код и стоимость выполнения

Agent Canvas и SDK доступны как открытые проекты. Облачный сервис OpenHands Cloud — коммерческое предложение. При самостоятельном запуске отдельно учитываются модель, вычисления и внешние инструменты. Лицензии компонентов описаны в их репозиториях; открытая экосистема не означает, что любые облачные ресурсы предоставляются без оплаты.

Если удобнее работать внутри привычного редактора, можно сопоставить этот подход с Cursor и Windsurf. Сравнивайте на одном небольшом репозитории и одинаковой задаче, оценивая изменения и проверку результата.

Частые вопросы об OpenHands

Нужно ли устанавливать OpenHands?

Для собственного локального окружения требуется установка. При использовании управляемого Cloud серверную часть обслуживает сервис. Актуальные варианты перечислены во вводной документации OpenHands.

Старые инструкции Docker Local GUI ещё подходят?

Прежний Local GUI относится к устаревшим компонентам. Для нового браузерного интерфейса документация рекомендует Agent Canvas. Сначала сверяйте название компонента в инструкции, особенно если материал посвящён старой архитектуре.

Можно пользоваться через терминал?

OpenHands CLI существует, но документация относит его к завершённым компонентам, которые преимущественно поддерживаются ради стабильности. Для нового знакомства с актуальным интерфейсом полезно начать с Canvas.

У OpenHands есть API?

Да. Agent Server предоставляет программный доступ к выполнению задач, разговорам, инструментам и рабочим пространствам. Python SDK предназначен для встраивания агента в собственные приложения и процессы.