CoolFace
Apppublic

umar141/Cerebrow-Browser-Agent

sourceHugging Faceupdated 5mo agoView on Hugging Face
0likes
App README

Cerebrow AI Agent

<br/>

Cerebrow: is built on Gradio and supports most of browser-use functionalities. This UI is designed to be user-friendly and enables easy interaction with the browser agent.

Expanded LLM Support: We've integrated support for various Large Language Models (LLMs), including: Google, OpenAI, Azure OpenAI, Anthropic, DeepSeek, Ollama etc. And we plan to add support for even more models in the future.

Custom Browser Support: You can use your own browser with our tool, eliminating the need to re-login to sites or deal with other authentication challenges. This feature also supports high-definition screen recording.

Installation Guide

Option 1: Local Installationcd cerebrow-1

Follow the steps below to get started.

Step 1: Clone the Repository
bash
git clone hhttps://github.com/uchihasosuke/Cerebrow-1.git
cd Cerebrow-1
Step 2: Set Up Python Environment

We recommend using uv for managing the Python environment.

Using uv (recommended):

bash
uv venv --python 3.11

Activate the virtual environment:

  • —Windows (Command Prompt):
cmd
.venv\Scripts\activate
  • —Windows (PowerShell):
powershell
.\.venv\Scripts\Activate.ps1
  • —macOS/Linux:
bash
source .venv/bin/activate
Step 3: Install Dependencies

Install Python packages:

bash
uv pip install -r requirements.txt

Install Browsers in playwright.

bash
playwright install --with-deps

Or you can install specific browsers by running:

bash
playwright install chromium --with-deps

Or

bash
python -m playwright install chromium
Step 4: Configure Environment
  1. 1.Create a copy of the example environment file:
  2. 2.Windows (Command Prompt):
bash
copy .env.example .env
  • —macOS/Linux/Windows (PowerShell):
bash
cp .env.example .env
  1. 1.Open .env in your preferred text editor and add your API keys and other settings
Step 5: Enjoy Cerebrow
  1. 1.Run Cerebrow:
bash
    python webui.py --ip 127.0.0.1 --port 7788
  1. 1.Access Cerebrow: Open your web browser and navigate to http://127.0.0.1:7788.
  2. 2.Using Your Own Browser(Optional):
  3. 3.Set BROWSER_PATH to the executable path of your browser and BROWSER_USER_DATA to the user data directory of your browser. Leave BROWSER_USER_DATA empty if you want to use local user data.
  4. 4.Windows
env
         BROWSER_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
         BROWSER_USER_DATA="C:\Users\YourUsername\AppData\Local\Google\Chrome\User Data"
Note: Replace YourUsername with your actual Windows username for Windows systems.
  • —Mac
env
         BROWSER_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
         BROWSER_USER_DATA="/Users/YourUsername/Library/Application Support/Google/Chrome"