<picture>
<source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125">
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/6797d09b-8ac3-4cb9-ba07-b289e080765a">

🌤️ Хотите пропустить настройку? Используйте наш облачный сервис для более быстрой, масштабируемой и скрытной автоматизации браузера!

🤖 Быстрый старт с LLM

1. Направьте вашего любимого агента для кодирования (Cursor, Claude Code и т.д.) в Agents.md
2. Начинайте!

👋 Быстрый старт для людей

Browser Use 0.13 представляет нового бета-агента, работающего на ядре Rust и специальной среде для браузера, созданной для современных моделей нового поколения. Он предоставляет модели реальное пространство действий для браузера/компьютера, инструменты с сохранением состояния и циклы восстановления, вдохновлённые агентами для кодирования.

Python API -> ядро Rust -> среда для браузера -> Веб-задача выполнена

1. Установите Browser Use с нативным ядром (Python>=3.11):

uv add "browser-use[core]"
# или: pip install "browser-use[core]"
browser

Дополнительный компонент [core] устанавливает нативную среду выполнения Browser Use для вашей платформы.

2. [Необязательно] Получите ваш API-ключ из Browser Use Cloud:

# .env
BROWSER_USE_API_KEY=your-key
# GOOGLE_API_KEY=your-key
# ANTHROPIC_API_KEY=your-key

3. Запустите вашего первого агента:

Терминал Browser Use:

uv add "browser-use[core]"
browser

Скрипт на Python:

from browser_use.beta import Agent, BrowserProfile, ChatBrowserUse
# from browser_use.beta import ChatOpenAI  # ChatOpenAI(model='gpt-5.5')
# from browser_use.beta import ChatAnthropic  # ChatAnthropic(model='claude-opus-4-8')
import asyncio

async def main():
    agent = Agent(
        task="Find the number of stars of the browser-use repo",
        llm=ChatBrowserUse(model='openai/gpt-5.5'),
        # llm=ChatBrowserUse(model='bu-2-0'),  # Browser Use's own optimized model
        # llm=ChatOpenAI(model='gpt-5.5'),
        # llm=ChatAnthropic(model='claude-opus-4-8'),  # Sonnet also works well.
        browser_profile=BrowserProfile(
            headless=False,
            allowed_domains=["*.github.com"],
        ),
    )
    history = await agent.run()
    print(history.final_result())

if __name__ == "__main__":
    asyncio.run(main())

Существующие пользователи Python-агента могут продолжать использовать from browser_use import Agent. Новый бета-агент на базе Rust импортируется через from browser_use.beta import Agent.

Ознакомьтесь с документацией библиотеки и документацией по облаку для получения дополнительной информации!

Open Source vs Облако

Мы проводим тестирование Browser Use на 100 реальных задач для браузера. Полный набор тестов доступен в открытом доступе: browser-use/benchmark.

Использование агента Open Source - Вам нужны пользовательские инструменты или глубокая интеграция на уровне кода - Мы рекомендуем использовать его в связке с нашими облачными браузерами для ведущей скрытности, смены прокси и масштабирования - Или разверните агента Open Source полностью на собственных серверах

Использование Полностью Развернутого Облачного Агента (рекомендуется) - Гораздо более мощный агент для сложных задач (см. график выше) - Самый простой способ начать и масштабироваться - Лучшая скрытность с ротацией прокси и решением капч - Более 1000 интеграций (Gmail, Slack, Notion и другие) - Постоянная файловая система и память

Демо

📋 Заполнение форм

Задача = "Заполните эту заявку на работу с помощью моего резюме и информации."

Пример кода ↗

🍎 Покупка продуктов

Задача = "Добавьте этот список товаров в мой instacart."

https://github.com/user-attachments/assets/a6813fa7-4a7c-40a6-b4aa-382bf88b1850

Пример кода ↗

💻 Персональный помощник.

Задача = "Помогите мне найти детали для сборки персонального компьютера."

https://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06

Пример кода ↗

💡Посмотрите больше примеров здесь ↗ и поставьте нам звездочку!

🚀 Быстрый старт с шаблонами

Хотите начать еще быстрее? Сгенерируйте готовый к запуску шаблон:

uvx browser-use init --template default

Это создаст файл browser_use_default.py с рабочим примером. Доступные шаблоны: - default - Минимальная настройка для быстрого старта - advanced - Все параметры конфигурации с подробными комментариями - tools - Примеры пользовательских инструментов и расширения агента

Вы также можете указать пользовательский путь для вывода:

uvx browser-use init --template default --output my_agent.py

💻 CLI

Быстрая, постоянная автоматизация браузера из командной строки:

browser-use open https://example.com    # Перейти по URL
browser-use state                       # Посмотреть кликабельные элементы
browser-use click 5                     # Нажать на элемент по индексу
browser-use type "Hello"                # Ввести текст
browser-use screenshot page.png         # Сделать скриншот
browser-use close                       # Закрыть браузер

CLI поддерживает работающий браузер между командами для быстрой итерации. Смотрите документацию по CLI) для всех команд.

Навык Claude Code

Для Claude Code установите навык для включения ИИ-помощника по автоматизации браузера:

mkdir -p ~/.claude/skills/browser-use
curl -o ~/.claude/skills/browser-use/SKILL.md \
  https://raw.githubusercontent.com/browser-use/browser-use/main/skills/browser-use/SKILL.md

Интеграции, хостинг, пользовательские инструменты, MCP и многое другое в нашей Документации ↗

Часто задаваемые вопросы

Какую модель лучше всего использовать?

Мы специально оптимизировали ChatBrowserUse() для задач автоматизации браузера. В среднем он выполняет задачи в 3-5 раз быстрее других моделей с передовой точностью.

Для получения информации о ценах и других поставщиках LLM смотрите нашу документацию по поддерживаемым моделям.

Могу ли я использовать Claude / GPT / Gemini через ChatBrowserUse?

Да. ChatBrowserUse принимает ID моделей с префиксом провайдера, поэтому один BROWSER_USE_API_KEY обеспечивает доступ ко всем им — отдельные ключи OpenAI/Anthropic/Google не требуются:

from browser_use import Agent, ChatBrowserUse

llm = ChatBrowserUse(model='anthropic/claude-sonnet-4-6')  # или 'openai/gpt-5.5', 'google/gemini-3-pro'
agent = Agent(task='...', llm=llm)

Для лучшей скорости и стоимости мы по-прежнему рекомендуем модели по умолчанию bu-*.

Должен ли я использовать системный промпт Browser Use с open-source предпросмотрной моделью?

Да. Если вы используете ChatBrowserUse(model='browser-use/bu-30b-a3b-preview') с обычным Agent(...), Browser Use по-прежнему будет отправлять системный промпт агента по умолчанию за вас.

Вам не нужно добавлять отдельное пользовательское "системное сообщение Browser Use" только потому, что вы переключились на модель предпросмотра в открытом исходном коде. Используйте extend_system_message или override_system_message только тогда, когда вы намеренно хотите настроить поведение по умолчанию для вашей задачи.

Если вы хотите получить лучшую скорость/точность по умолчанию, мы по-прежнему рекомендуем более новые хостинговые модели bu-*. Если вы хотите модель предпросмотра в открытом исходном коде, настройка остается прежней, за исключением значения model=.

Могу ли я использовать пользовательские инструменты с агентом?

Да! Вы можете добавить пользовательские инструменты для расширения возможностей агента:

from browser_use import Tools

tools = Tools()

@tools.action(description='Description of what this tool does.')
def custom_tool(param: str) -> str:
  return f"Result: {param}"

agent = Agent(
  task="Your task",
  llm=llm,
  browser=browser,
  tools=tools,
)

Могу ли я использовать это бесплатно?

Да! Browser-Use — это проект с открытым исходным кодом и он бесплатен для использования. Вам нужно только выбрать поставщика LLM (например, OpenAI, Google, ChatBrowserUse или запускать локальные модели с помощью Ollama).

Условия использования

Эта библиотека с открытым исходным кодом лицензирована по лицензии MIT. Для использования сервисов Browser Use и политики обработки данных смотрите наши Условия использования и Политику конфиденциальности.

Как обрабатывать аутентификацию?

Ознакомьтесь с нашими примерами аутентификации: - Использование реальных профилей браузера - Повторное использование вашего существующего профиля Chrome с сохраненными логинами - Если вы хотите использовать временные аккаунты с почтовым ящиком, выберите AgentMail - Чтобы синхронизировать ваш профиль аутентификации с удаленным браузером, выполните curl -fsSL https://browser-use.com/profile.sh | BROWSER_USE_API_KEY=XXXX sh (замените XXXX на ваш API-ключ)

Эти примеры показывают, как поддерживать сеансы и бесшовно обрабатывать аутентификацию.

Как решать CAPTCHA?

Для обработки CAPTCHA необходима лучшая идентификация браузера и прокси-серверы. Используйте Browser Use Cloud, который предоставляет скрытные браузеры, разработанные для избежания обнаружения и проверок CAPTCHA.

Как выйти в продакшн?

Chrome может потреблять много памяти, а запуск множества агентов параллельно может быть сложно управлять.

Для продакшн-сценариев используйте наш API Browser Use Cloud, который обеспечивает: - Масштабируемую инфраструктуру браузеров - Управление памятью - Ротацию прокси - Скрытную идентификацию браузера - Высокопроизводительное параллельное выполнение

Скажите компьютеру, что делать, и он это сделает.