Содержание
Browser Use и GitHub: установка и работа с проектом
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 18 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Browser Use и GitHub: установка и работа с проектом — это открытая библиотека для агентов, которые управляют браузером. Репозиторий на GitHub даёт три пути: полностью облачный агент, CLI для существующих агентов и Python-библиотеку для локального запуска. Ниже — установка, код, диагностика. Мы скачали подборку результатов веб-поиска по запросу «Browser Use и GitHub: установка и работа с проектом»: текст отдали 8 из 10.
Что такое Browser Use и где здесь GitHub
Browser Use — открытый браузерный агент, который живёт в репозитории на GitHub. По описанию самого проекта, это open-source browser agent, который запускается локально с любой LLM или в Browser Use Cloud. В документации проекта указано, что Browser Use существует в двух языковых вариантах — Python и TypeScript, а облачный браузер стоит $0.02 за час работы браузера и включает stealth, решение CAPTCHA и резидентные прокси.
Репозиторий на GitHub — это точка входа: README, установка, примеры кода и ссылки на документацию. В описании проекта отдельно отмечено, что для агентов и краулеров есть карта продукта по адресу browser-use.com/llms.txt и индекс документации по docs.browser-use.com/llms.txt.
Границы продукта стоит держать в голове сразу. Библиотека Python бесплатна и распространяется под лицензией MIT. Инференс модели и облачные браузеры оплачиваются отдельно: провайдеры API, включая ChatBrowserUse, и Browser Use Cloud берут плату за использование. Локальный браузер с локальной моделью через Ollama тоже возможен — в пределах вашего железа и требований модели.
Отдельно существует Browser Use Desktop — приложение, которое запускает команду браузерных агентов на вашем рабочем столе. По описанию проекта, оно переносит cookies в свежий Chromium, чтобы агенты были залогинены там же, где вы, и запускает задачи по горячей клавише. Это отдельный продукт со своим репозиторием, и путать его с библиотекой не стоит.
Условия доступа и где смотреть актуальные требования
Актуальные требования живут в README репозитория и в документации проекта. По README, для установки библиотеки нужен Python версии 3.11 и выше. Для установки через uv рекомендуется Python 3.12: команда uv init --python 3.12 создаёт новый проект.
Ключи доступа зависят от выбранного пути. Для локального запуска с моделью OpenAI нужен ключ OpenAI в файле .env. Для любого из двух опциональных сервисов Browser Use — облачного браузера или модели BU2 — нужен ключ Browser Use API. В README указано, что локальный Chrome не требует ключа Browser Use API: облако опционально.
Таблица ниже сводит три пути запуска по тому, что каждый из них требует.
| Путь | Что запускает | Ключ | Где выполняется |
|---|---|---|---|
| Fully Hosted Cloud | агент, браузер и инфраструктуру | Browser Use API | облако Browser Use |
| CLI | браузер для существующего агента | зависит от агента | локальный или облачный браузер |
| Python Library | агента из вашего кода | ключ провайдера модели | локально или в облаке |
По README, CLI и Python-библиотека могут подключаться к локальному или облачному браузеру. Облачный браузер размещает браузер; полностью размещённый API запускает ещё и агента. Эта разница определяет, что именно вы оплачиваете и что контролируете.
Источник актуальных требований — сам репозиторий и документация проекта. README обновляется вместе с кодом, поэтому версии Python, имена моделей и команды установки стоит сверять там перед запуском. Документация GitHub по подключению к GitHub описывает вход в аккаунт, работу в браузере и с рабочего стола, а также сравнение средств подключения — это справочный слой для работы с самим GitHub, отдельный от Browser Use.
Порядок установки: три документированных пути
Установка библиотеки описана в README пошагово. Первый шаг — установить Browser Use, требуется Python 3.11 и выше. Второй шаг — добавить ключ OpenAI API в файл .env. В README приведён образец файла: строка OPENAI_API_KEY=your-key, закомментированная строка BROWSER_USE_API_KEY=your-key и пометка, что это опционально для модели BU2 или облачного браузера.
Дальше идёт код агента. В README приведён пример на Python: импортируются asyncio, классы Agent, Browser, ChatBrowserUse, ChatOpenAI и load_dotenv. Внутри асинхронной функции создаётся модель ChatOpenAI с параметрами модели и reasoning_effort, затем агент с задачей «Find the number of stars of the browser-use repo», после чего вызывается agent.run() и печатается history.final_result().
Задача в примере — узнать число звёзд репозитория browser-use. По README, агент открывает браузер, находит репозиторий и печатает ответ. Это минимальный учебный сценарий: он проверяет, что модель отвечает, браузер стартует и результат возвращается в код.
Пятый шаг в README — запустить того же агента на облачном браузере. Для этого нужно задать BROWSER_USE_API_KEY, раскомментировать строку browser= в файле агента и запустить снова. В README отмечено, что облачный браузер не требует установки Chrome и работает в Docker, CI и serverless-средах. Код меняется минимально: в конструктор агента добавляется browser=Browser(use_cloud=True).
Отдельная ветка — установка browser-harness, описанная в его install.md. Быстрый путь: команда uv tool install --python 3.12 --upgrade --force browser-harness, затем создание директории skill и запись browser-harness skill в файл SKILL.md, после чего запуск browser-harness с вызовом page_info(). В документе поясняется, что флаг --python 3.12 не даёт uv выбрать старые релизы, а --upgrade --force заменяет предыдущую установку последним стабильным релизом, не удаляя посторонние команды.
Для Claude Code и других агентов в install.md описан порядок: установить browser-harness, зарегистрировать skill с именем browser-harness, использовать browser-harness skill как тело и задать триггер. Триггер в документе сформулирован так: всегда использовать browser-harness для любого веб-взаимодействия — автоматизации, скрейпинга, тестирования или работы с сайтом.
Учебный пример: агент читает репозиторий
Ниже — сценарий README, дополненный критериями проверки. При установленном uv создайте проект и добавьте библиотеку:
uv init --python 3.12
uv add browser-use
Создайте .env со своим ключом модели:
OPENAI_API_KEY=your-key
# BROWSER_USE_API_KEY=your-key
Вторая строка нужна для опциональной модели BU2 или облачного браузера. Сохраните agent.py:
import asyncio
from browser_use import Agent, Browser, ChatBrowserUse, ChatOpenAI
from dotenv import load_dotenv
load_dotenv()
async def main():
llm = ChatOpenAI(model="gpt-5.6-luna", reasoning_effort="xhigh")
# llm = ChatBrowserUse(model="bu-2-0")
agent = Agent(
task="Find the number of stars of the browser-use repo",
llm=llm,
# browser=Browser(use_cloud=True),
)
history = await agent.run()
print(history.final_result())
if __name__ == "__main__":
asyncio.run(main())
Запустите uv run agent.py. Модель и reasoning_effort приведены как в сохранённом README; перед работой проверьте доступность выбранной модели у своего провайдера. Для облачного браузера задайте BROWSER_USE_API_KEY и раскомментируйте browser=Browser(use_cloud=True).
Критерии самостоятельной проверки: процесс завершился без исключения; ответ относится к репозиторию browser-use; число звёзд сверено с открытой страницей на момент запроса; при повторном запуске проверяется актуальное значение. При смене на облачный браузер сравните тот же сценарий. Это учебный образец из документации; читатель проверяет запуск самостоятельно.
Смежные варианты: что выбирать по задаче
Три пути в README закрывают разные задачи. Полностью размещённый облачный агент подходит, когда нужно масштабирование: по README, задачи отправляются через API, а Browser Use запускает агента, браузер и инфраструктуру. CLI даёт браузерный доступ существующему агенту — Claude Code, Codex, Hermes, OpenClaw, Pi, Cursor и другим, интерактивно или в скриптах. Python-библиотека запускает открытый агент локально из вашего кода.
Облачный браузер — отдельная опция внутри CLI и библиотеки. По README, он добавляет stealth, резидентные прокси, решение CAPTCHA и ссылку на живой просмотр, а код остаётся тем же. Стоимость — $0.02 за час браузера плюс сетевой трафик. Включение: Browser(use_cloud=True) и ключ BROWSER_USE_API_KEY.
Модель тоже выбирается. В README рекомендуется BU2 — модель, оптимизированная под браузерную автоматизацию, через ChatBrowserUse(model='bu-2-0'), с ключом BROWSER_USE_API_KEY. ChatBrowserUse принимает идентификаторы моделей с префиксом провайдера через шлюз Browser Use, например anthropic/claude-sonnet-4-6 или google/gemini-3-pro. Провайдеров можно подключать напрямую через обёртки ChatOpenAI, ChatAnthropic, ChatGoogle с их собственными ключами.
Для Claude есть отдельный набор инструментов. По README, Browser Use реализует все 31 браузерное действие и управляет локальным браузером, облачным браузером Browser Use или существующим удалённым браузером по CDP. Bash включён в интеграцию для обработки данных и записи файлов. Требуется версия Anthropic SDK, включающая anthropic.tools.browser; Bash требует Linux или macOS с /bin/bash, на Windows нужен WSL.
| Что выбрать | Когда подходит | Что нужно |
|---|---|---|
| Cloud-агент | масштаб, инфраструктура на стороне сервиса | ключ Browser Use API |
| CLI | у вас уже есть агент, нужен браузер | установленный агент |
| Python-библиотека | свой код и контроль | Python 3.11+, ключ модели |
| Desktop | команда агентов на рабочем столе | установщик под вашу ОС |
Browser Use Desktop публикует сборки под конкретные системы: для macOS на Apple Silicon — Browser-Use-arm64.dmg, для Windows x64 — Browser-Use-Setup.exe, для Linux — Browser-Use-x64.AppImage с автообновлением внутри приложения, а также пакеты .deb и .rpm на GitHub Releases для ручной установки. По README проекта, кнопки и ссылки всегда указывают на последний релиз. Для работы Desktop нужна подписка или ключ Anthropic для Claude Code либо подписка или ключ ChatGPT для Codex.
Типичные проблемы и диагностика
Основные сбои связаны с подключением к браузеру. В install.md browser-harness перечислены проверяемые состояния. Сообщение chrome running FAIL означает, что Chrome не запущен: документ предлагает попросить пользователя открыть Chrome или использовать изолированный либо облачный браузер. Сообщение daemon alive FAIL означает, что отсутствует разрешение на удалённую отладку Chrome, Chrome закрыт или конечная точка CDP недоступна.
Порядок диагностики для локального Chrome описан так. Откройте chrome://inspect/#remote-debugging. Отметьте пункт «Allow remote debugging for this browser instance». Если на macOS сообщается о блокировке разрешения, обработайте системное окно Allow для каждого подключения. Продолжайте работу, когда помощник вернёт ready; иначе следуйте напечатанной инструкции. В документе отмечено, что первая галочка — намеренно ручной шаг настройки Chrome, и до появления CDP она помощнику недоступна.
Разрешения на macOS — отдельная точка отказа. По install.md, помощнику нужно разрешение Accessibility для приложения, запускающего CLI: Terminal, iTerm, Codex или IDE, — оно выдаётся в System Settings.
Для машинной проверки здоровья в install.md есть команда browser-harness doctor --json --require-existing-daemon. Она печатает версионированный JSON-отчёт и завершается с ненулевым кодом, если у указанного демона нет живого подключения к браузеру. Документ подчёркивает: команда не запускает и не ищет другой браузер. Оркестратор может задать BU_NAME для уже подготовленного демона и запустить проверку.
Если сбой сохраняется, install.md предлагает смотреть исходники: src/browser_harness/admin.py, src/browser_harness/daemon.py и src/browser_harness/_ipc.py. Обновление выполняется командой browser-harness --update -y, отключение телеметрии — browser-harness telemetry disable. Состояние по умолчанию лежит в ${XDG_CONFIG_HOME:-~/.config}/browser-harness: авторизация, идентификатор телеметрии, рабочая область агента, сокеты, логи, скриншоты и временные файлы. Переопределить путь можно через BH_HOME или BROWSER_HARNESS_HOME.
Ещё одна частая причина — устаревший skill. В install.md сказано: если подхватывается старый пользовательский skill браузера, удалите его директорию вручную. Кэши плагинов и встроенные каталоги редактировать не нужно.
Частые вопросы
Что такое Browser Use на GitHub?
Это открытый репозиторий браузерного агента, который запускается локально с любой LLM или в облаке Browser Use. В README он описан как open-source browser agent на Python и TypeScript. Репозиторий содержит README, примеры кода и ссылки на документацию проекта. Отдельно существуют репозитории Desktop и browser-harness.
Какая версия Python нужна для установки?
В README указано требование Python 3.11 и выше для библиотеки. Для установки через uv рекомендуется Python 3.12: команда uv init --python 3.12 создаёт новый проект. В install.md browser-harness флаг --python 3.12 не даёт uv выбрать старые релизы. Точные требования стоит сверять в README перед запуском.
Нужен ли ключ API для локального запуска?
Для локального браузера ключ Browser Use API не нужен — в install.md сказано, что облако опционально. Ключ нужен для модели: в README ключ OpenAI API кладётся в .env. Ключ Browser Use API требуется для модели BU2 и для облачного браузера. Локальная модель через Ollama работает в пределах вашего железа.
Сколько стоит облачный браузер?
В README указана цена $0.02 за час работы браузера плюс сетевой трафик. Облачный браузер добавляет stealth, резидентные прокси, решение CAPTCHA и ссылку на живой просмотр. Библиотека Python при этом бесплатна и распространяется под лицензией MIT. Инференс модели и облачные браузеры оплачиваются отдельно.
Что делать, если агент не подключается к Chrome?
Проверьте, запущен ли Chrome: сообщение chrome running FAIL указывает именно на это. Откройте chrome://inspect/#remote-debugging и разрешите удалённую отладку для этого экземпляра браузера. На macOS выдайте разрешение Accessibility приложению, из которого запускается CLI. Для машинной проверки используйте browser-harness doctor --json --require-existing-daemon.