{"id":24114514,"url":"https://github.com/browser-use/web-ui","last_synced_at":"2025-05-13T15:01:56.434Z","repository":{"id":270654383,"uuid":"910986056","full_name":"browser-use/web-ui","owner":"browser-use","description":"Run AI Agent in your browser.","archived":false,"fork":false,"pushed_at":"2025-05-05T12:38:36.000Z","size":31730,"stargazers_count":12754,"open_issues_count":259,"forks_count":2089,"subscribers_count":110,"default_branch":"main","last_synced_at":"2025-05-05T22:16:11.014Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/browser-use.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-02T01:29:44.000Z","updated_at":"2025-05-05T21:33:22.000Z","dependencies_parsed_at":"2025-02-15T01:21:16.272Z","dependency_job_id":"dbc8cdfe-f6de-4274-8a68-807f9f76003e","html_url":"https://github.com/browser-use/web-ui","commit_stats":null,"previous_names":["warmshao/browser-use-webui","browser-use/web-ui"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fweb-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fweb-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fweb-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fweb-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browser-use","download_url":"https://codeload.github.com/browser-use/web-ui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253967861,"owners_count":21992251,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-11T05:01:37.910Z","updated_at":"2025-05-13T15:01:56.416Z","avatar_url":"https://github.com/browser-use.png","language":"Python","readme":"\u003cimg src=\"./assets/web-ui.png\" alt=\"Browser Use Web UI\" width=\"full\"/\u003e\n\n\u003cbr/\u003e\n\n[![GitHub stars](https://img.shields.io/github/stars/browser-use/web-ui?style=social)](https://github.com/browser-use/web-ui/stargazers)\n[![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA\u0026label=Discord\u0026logo=discord\u0026logoColor=white)](https://link.browser-use.com/discord)\n[![Documentation](https://img.shields.io/badge/Documentation-📕-blue)](https://docs.browser-use.com)\n[![WarmShao](https://img.shields.io/twitter/follow/warmshao?style=social)](https://x.com/warmshao)\n\nThis project builds upon the foundation of the [browser-use](https://github.com/browser-use/browser-use), which is designed to make websites accessible for AI agents.\n\nWe would like to officially thank [WarmShao](https://github.com/warmshao) for his contribution to this project.\n\n**WebUI:** 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.\n\n**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.\n\n**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.\n\n**Persistent Browser Sessions:** You can choose to keep the browser window open between AI tasks, allowing you to see the complete history and state of AI interactions.\n\n\u003cvideo src=\"https://github.com/user-attachments/assets/56bc7080-f2e3-4367-af22-6bf2245ff6cb\" controls=\"controls\"\u003eYour browser does not support playing this video!\u003c/video\u003e\n\n## Installation Guide\n\n### Option 1: Local Installation\n\nRead the [quickstart guide](https://docs.browser-use.com/quickstart#prepare-the-environment) or follow the steps below to get started.\n\n#### Step 1: Clone the Repository\n```bash\ngit clone https://github.com/browser-use/web-ui.git\ncd web-ui\n```\n\n#### Step 2: Set Up Python Environment\nWe recommend using [uv](https://docs.astral.sh/uv/) for managing the Python environment.\n\nUsing uv (recommended):\n```bash\nuv venv --python 3.11\n```\n\nActivate the virtual environment:\n- Windows (Command Prompt):\n```cmd\n.venv\\Scripts\\activate\n```\n- Windows (PowerShell):\n```powershell\n.\\.venv\\Scripts\\Activate.ps1\n```\n- macOS/Linux:\n```bash\nsource .venv/bin/activate\n```\n\n#### Step 3: Install Dependencies\nInstall Python packages:\n```bash\nuv pip install -r requirements.txt\n```\n\nInstall Browsers in Patchright. \n```bash\npatchright install --with-deps\n```\nOr you can install specific browsers by running:\n```bash\npatchright install chromium --with-deps\n```\n\n#### Step 4: Configure Environment\n1. Create a copy of the example environment file:\n- Windows (Command Prompt):\n```bash\ncopy .env.example .env\n```\n- macOS/Linux/Windows (PowerShell):\n```bash\ncp .env.example .env\n```\n2. Open `.env` in your preferred text editor and add your API keys and other settings\n\n#### Step 5: Enjoy the web-ui\n1.  **Run the WebUI:**\n    ```bash\n    python webui.py --ip 127.0.0.1 --port 7788\n    ```\n2. **Access the WebUI:** Open your web browser and navigate to `http://127.0.0.1:7788`.\n3. **Using Your Own Browser(Optional):**\n    - 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.\n      - Windows\n        ```env\n         BROWSER_PATH=\"C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe\"\n         BROWSER_USER_DATA=\"C:\\Users\\YourUsername\\AppData\\Local\\Google\\Chrome\\User Data\"\n        ```\n        \u003e Note: Replace `YourUsername` with your actual Windows username for Windows systems.\n      - Mac\n        ```env\n         BROWSER_PATH=\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\"\n         BROWSER_USER_DATA=\"/Users/YourUsername/Library/Application Support/Google/Chrome\"\n        ```\n    - Close all Chrome windows\n    - Open the WebUI in a non-Chrome browser, such as Firefox or Edge. This is important because the persistent browser context will use the Chrome data when running the agent.\n    - Check the \"Use Own Browser\" option within the Browser Settings.\n\n### Option 2: Docker Installation\n\n#### Prerequisites\n- Docker and Docker Compose installed\n  - [Docker Desktop](https://www.docker.com/products/docker-desktop/) (For Windows/macOS)\n  - [Docker Engine](https://docs.docker.com/engine/install/) and [Docker Compose](https://docs.docker.com/compose/install/) (For Linux)\n\n#### Step 1: Clone the Repository\n```bash\ngit clone https://github.com/browser-use/web-ui.git\ncd web-ui\n```\n\n#### Step 2: Configure Environment\n1. Create a copy of the example environment file:\n- Windows (Command Prompt):\n```bash\ncopy .env.example .env\n```\n- macOS/Linux/Windows (PowerShell):\n```bash\ncp .env.example .env\n```\n2. Open `.env` in your preferred text editor and add your API keys and other settings\n\n#### Step 3: Docker Build and Run\n```bash\ndocker compose up --build\n```\nFor ARM64 systems (e.g., Apple Silicon Macs), please run follow command:\n```bash\nTARGETPLATFORM=linux/arm64 docker compose up --build\n```\n\n#### Step 4: Enjoy the web-ui and vnc\n- Web-UI: Open `http://localhost:7788` in your browser\n- VNC Viewer (for watching browser interactions): Open `http://localhost:6080/vnc.html`\n  - Default VNC password: \"youvncpassword\"\n  - Can be changed by setting `VNC_PASSWORD` in your `.env` file\n\n## Changelog\n- [x] **2025/01/26:** Thanks to @vvincent1234. Now browser-use-webui can combine with DeepSeek-r1 to engage in deep thinking!\n- [x] **2025/01/10:** Thanks to @casistack. Now we have Docker Setup option and also Support keep browser open between tasks.[Video tutorial demo](https://github.com/browser-use/web-ui/issues/1#issuecomment-2582511750).\n- [x] **2025/01/06:** Thanks to @richard-devbot. A New and Well-Designed WebUI is released. [Video tutorial demo](https://github.com/warmshao/browser-use-webui/issues/1#issuecomment-2573393113).\n","funding_links":[],"categories":["Python","A01_文本生成_文本对话","\u003cimg src=\"./assets/satellite.svg\" width=\"16\" height=\"16\" style=\"vertical-align: middle;\"\u003e Satellites","🤖 AI \u0026 Machine Learning","Repos","Browser Control Agents","📚 Tutorials \u0026 Guides","🧠 AI Applications \u0026 Platforms","Uncategorized"],"sub_categories":["大语言对话模型及数据","🛠️ Agent Frameworks","Tools","Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowser-use%2Fweb-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowser-use%2Fweb-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowser-use%2Fweb-ui/lists"}