Introdução geral
O Browser Use Web UI é um projeto inovador de código aberto focado em fornecer aos agentes de IA uma ferramenta de interface gráfica para recursos de interação com o navegador. O projeto foi desenvolvido com base no uso do navegador Além da estrutura principal, uma interface da Web fácil de usar é criada por meio do Gradio, permitindo que os agentes de IA interajam com o navegador de forma conveniente. O projeto oferece suporte a uma variedade de LLMs (Large Language Models) convencionais, incluindo Gemini, OpenAI, Azure OpenAI, Anthropic, DeepSeek e Ollama. Particularmente digno de nota é o suporte da ferramenta para usuários que usam seus próprios navegadores, resolvendo problemas comuns como logins duplicados e autenticação. Em janeiro de 2025, o projeto recebeu 2.601 tags com estrelas no GitHub e tem 332 ramificações, demonstrando uma forte presença da comunidade.
Lista de funções
- Suporte para várias integrações de modelos de linguagem grandes (Gemini, OpenAI, Azure OpenAI, etc.)
- Suporte a navegadores personalizados com configurações individuais de navegador
- Persistência da sessão do navegador para dar suporte à manutenção do estado do navegador entre as tarefas de IA
- Oferece opções de implementação em contêineres do Docker
- Suporte ao processo de operação do navegador de visualização remota VNC
- Suporte à interface com vários temas (Ocean, Soft, Monochrome, Glass etc.)
- Suporta a alternância entre os modos claro e escuro
- Visualização da interação com o navegador em tempo real
- Suporte flexível à configuração de variáveis de ambiente
Usando a Ajuda
1. preparação ambiental
- Requisitos do ambiente Python: 3.11 ou superior
- Uso recomendado de ferramentas uv para configurar o ambiente Python
2. modalidades de instalação
Instalação local:
- Crie um ambiente virtual:
uv venv --python 3.11
fonte .venv/bin/activate
- Instale a dependência:
bash
uv pip install -r requirements.txt
playwright install
Instalação do Docker:
- Armazém de Clonagem:
bash
git clone https://github.com/browser-use/web-ui.git
cd web-ui
- Configure o ambiente:
- Copiar .env.example para .env
- Configure as chaves de API e as variáveis de ambiente necessárias
- Inicie o serviço:
bash
docker compose up --build
3. orientação sobre o uso de funções essenciais
Inicialização da WebUI:
bash
python webui.py --ip 127.0.0.1 --port 7788
Configuração do navegador pessoal:
- Exemplo de configuração do sistema Windows:
env
CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
CHROME_USER_DATA="C:\Usuários\Seu nome de usuário\AppData\Local\Google\Chrome\Dados do usuário"
- Exemplo de configuração do sistema Mac:
env
CHROME_PATH="/Aplicativos/Google Chrome.app/Contents/MacOS/Google Chrome"
CHROME_USER_DATA="~/Biblioteca/Suporte a Aplicativos/Google/Chrome/Profile 1"
Gerenciamento de sessões do navegador:
- Modo de sessão temporária: feche o navegador após a conclusão de cada tarefa de IA
- Modo de sessão persistente: a configuração de um modo de sessão persistente é realizada definindo o parâmetro
CHROME_PERSISTENT_SESSION=true
começar a usar
Recursos avançados para ambientes Docker:
- Visualização remota VNC: acesso
http://localhost:6080/vnc.html
- Personalização da resolução: por meio de variáveis de ambiente
RESOLUÇÃO
configurar - Acesso seguro: senha VNC personalizável
4. dicas de solução de problemas:
- Certifique-se de fechar todas as janelas do Chrome ao usar um navegador personalizado
- Navegadores que não sejam do tipo Chrome (por exemplo, Firefox ou Edge) são recomendados para acesso à WebUI.
- Verifique os registros quando o Docker for implantado:
docker compose logs -f