{"id":24884179,"url":"https://github.com/webhiveos/webhive","last_synced_at":"2025-04-13T18:42:34.578Z","repository":{"id":274863248,"uuid":"924292237","full_name":"webhiveos/WebHive","owner":"webhiveos","description":"Meet WebHive, the AI-powered browser that takes care of tasks for you. No more endless clicks, tell it what you need, and it gets it done.","archived":false,"fork":false,"pushed_at":"2025-02-13T22:11:48.000Z","size":1799,"stargazers_count":11,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T09:27:08.456Z","etag":null,"topics":["agent","agent-framework","assistant","chagpt","chatgpt-app","chatgpt-operator","claude","computer-use","gca","gpt","gpt-4o","langchain","llms","mcp","model-context-protocol","openai"],"latest_commit_sha":null,"homepage":"https://webhiveos.xyz/","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/webhiveos.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}},"created_at":"2025-01-29T18:42:41.000Z","updated_at":"2025-03-18T13:11:55.000Z","dependencies_parsed_at":"2025-02-12T23:31:14.569Z","dependency_job_id":"bf527927-013b-44aa-9a0b-09305a808cfc","html_url":"https://github.com/webhiveos/WebHive","commit_stats":null,"previous_names":["arjunagarwaldubai/webhiveos","webhiveos/webhive"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webhiveos%2FWebHive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webhiveos%2FWebHive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webhiveos%2FWebHive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webhiveos%2FWebHive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webhiveos","download_url":"https://codeload.github.com/webhiveos/WebHive/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248764893,"owners_count":21158174,"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":["agent","agent-framework","assistant","chagpt","chatgpt-app","chatgpt-operator","claude","computer-use","gca","gpt","gpt-4o","langchain","llms","mcp","model-context-protocol","openai"],"created_at":"2025-02-01T14:19:40.067Z","updated_at":"2025-04-13T18:42:34.549Z","avatar_url":"https://github.com/webhiveos.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/github.png\" alt=\"WebHive Logo\" width=\"800\"\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\u003cbr/\u003e\n\n\n[![Discord](https://img.shields.io/badge/Discord-WebHiveOS-blue)](https://discord.com/invite/7kqEFAZc)\n[![Documentation](https://img.shields.io/badge/Documentation-📕-blue)](https://webhiveos.xyz/docs)\n[![WebHiveOS](https://img.shields.io/twitter/follow/WebHiveOS?style=social)](https://x.com/WebHiveOS)\n\n\u003e **Enhanced Version:** WebHive improves the original browser-use/web-ui project with new features while keeping compatibility. We thank the original creators for their great work.\n\n**WebHive** is a smart browser control center using AI. It works with:\n- All major AI models (Google, OpenAI, Anthropic, etc.)\n- Your existing browser profiles\n- Both simple and advanced tasks\n\n**AI Model Support:** Works with popular AI services\n\n**Use Your Own Browser:** Keep your logins and settings. Works with Chrome/Firefox/Edge. Records HD videos of AI actions.\n\n**Keep Browser Open:** Choose to maintain the browser window between tasks to see full history.\n\nhttps://github.com/user-attachments/assets/9a9eebfb-02bd-4463-97b2-73c8dec94206\n\n**Coming Soon:**\n- 🛒 **Hive Marketplace**: Buy/sell browser automation scripts using $HIVE tokens\n- 🤖 **Advanced Automation**: Multi-step workflows (e.g. multi job applications, data collection, automated LinkedIN networking)\n- 🔗 **Agent Networks**: Connect with other AI agents for complex tasks\n- 🎁 **Early Access**: $HIVE holders get first access to new features\n\n\u003e 💡 **$HIVE Token Utility**:\n\u003e - Purchase premium automations\n\u003e - Earn by selling your scripts\n\u003e - Get voting rights for feature development\n\u003e - Stake for passive income\n\u003cbr\u003e\n\n\u003cimg src=\"https://github.com/user-attachments/assets/8abe3ed3-5b48-4b39-b208-8afcdf3aabaf\" width=\"80%\"\u003e\n\n\u003cbr\u003e\n\n## Installation Guide\n\n### Local Installation\n\n#### 1. Get the Code\n```bash\ngit clone git@github.com:webhiveos/WebHive.git\ncd WebHive\n```\n\n#### 2. Setup Python\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#### 3. Install Requirements\nInstall Python packages:\n```bash\nuv pip install -r requirements.txt\n```\n\nInstall Playwright:\n```bash\nplaywright install\n```\n\n#### 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### 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#### Installation Steps\n1. Clone the repository:\n```bash\ngit clone git@github.com:webhiveos/WebHive.git\ncd WebHive\n```\n\n2. Create and configure 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```\nEdit `.env` with your preferred text editor and add your API keys\n\nfeature/arm64-support\n4. **Access the Application:**\n   - Web Hive Interface: `http://localhost:7788`\n   - VNC Viewer (to see browser interactions): `http://localhost:6080/vnc.html`\n   - Direct VNC access is available on port 5901 (especially useful for Mac users)\n   \n   Default VNC password is \"vncpassword\". You can change it by setting the `VNC_PASSWORD` environment variable in your `.env` file.\n\n3. Run with Docker:\n```bash\n# Build and start the container with default settings (browser closes after AI tasks)\ndocker compose up --build\n```\n```bash\n# Or run with persistent browser (browser stays open between AI tasks)\nCHROME_PERSISTENT_SESSION=true docker compose up --build\n```\n\n\n4. Access the Application:\n- Web Interface: 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\u003cbr\u003e\n\n\u003cimg src=\"https://github.com/user-attachments/assets/b24e3ae8-b7a7-4175-b601-5a0303cd3497\" width=\"80%\"\u003e\n\n## Usage\n\n### Local Setup\n1.  Copy `.env.example` to `.env` and set your environment variables, including API keys for the LLM. `cp .env.example .env`\n2.  **Run Web Hive:**\n    After completing the installation steps above, start the application:\n    ```bash\n    python webhive.py --ip 127.0.0.1 --port 7788\n    ```\n4. Web Hive options:\n- `--ip`: Specifies the IP address for binding Web Hive. The default value is `127.0.0.1`.  \n- `--port`: Defines the port Web Hive should use. Defaults to `7788`.  \n- `--theme`: Sets the user interface theme. The default is `Ocean`.  \n  - **Default**: A well-balanced theme with a standard design.  \n  - **Soft**: A muted, gentle color palette for a more relaxed viewing experience.  \n  - **Monochrome**: A grayscale theme that minimizes color for a clean and focused look.  \n  - **Glass**: A sleek, semi-transparent design for a modern aesthetic.  \n  - **Origin**: A retro-inspired theme that evokes nostalgia.  \n  - **Citrus**: A bright and refreshing palette with citrus-inspired tones.  \n  - **Ocean** *(default)*: A calming theme with ocean-inspired shades of blue.  \n- `--dark-mode`: Activates dark mode for the user interface.  \n3.  **Access Web Hive Interface:** Open your web browser and navigate to `http://127.0.0.1:7788`.\n4.  **Using Your Own Browser(Optional):**\n    - Set `CHROME_PATH` to the executable path of your browser and `CHROME_USER_DATA` to the user data directory of your browser.\n      - Windows\n        ```env\n         CHROME_PATH=\"C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe\"\n         CHROME_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         CHROME_PATH=\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\"\n         CHROME_USER_DATA=\"~/Library/Application Support/Google/Chrome/Profile 1\"\n        ```\n    - Close all Chrome windows\n    - Open Web Hive 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.\n5. **Keep Browser Open(Optional):**\n    - Set `CHROME_PERSISTENT_SESSION=true` in the `.env` file.\n\n### Docker Setup\n1. **Environment Variables:**\n   - All configuration is done through the `.env` file\n   - Available environment variables:\n     ```\n     # LLM API Keys\n     OPENAI_API_KEY=your_key_here\n     ANTHROPIC_API_KEY=your_key_here\n     GOOGLE_API_KEY=your_key_here\n\n     # Browser Settings\n     CHROME_PERSISTENT_SESSION=true  #Keeps the browser open between AI tasks if set to true.\n     RESOLUTION=1920x1080x24         # Defines resolution in WIDTHxHEIGHTxDEPTH format.\n     RESOLUTION_WIDTH=1920           # Sets the screen width in pixels.\n     RESOLUTION_HEIGHT=1080          # Sets the screen height in pixels.\n\n     # VNC Settings\n     VNC_PASSWORD=your_vnc_password  # (Optional) Specifies the VNC password. Defaults to \"vncpassword\" if not provided.\n     ```\n\n2. **Platform Support:**\n   - Supports both AMD64 and ARM64 architectures\n   - For ARM64 systems (e.g., Apple Silicon Macs), the container will automatically use the appropriate image\n\n3. **Browser Persistence Modes:**\n   - **Default Mode (CHROME_PERSISTENT_SESSION=false):**\n     - The browser opens and closes with each AI task.\n     - Provides a clean state for every interaction.\n     - Consumes fewer system resources.\n\n   - **Persistent Mode (CHROME_PERSISTENT_SESSION=true):**\n     - Keeps the browser open between AI tasks.\n     - Retains history and session state.\n     - Enables reviewing previous AI interactions.\n     - Can be configured in the .env file or set as an environment variable when launching the container.\n\n4. **Viewing Browser Interactions:**\n   - Open the noVNC viewer by navigating to: [`http://localhost:6080/vnc.html`](http://localhost:6080/vnc.html)  \n   - Enter the VNC password (default: `\"vncpassword\"` or the value set in `VNC_PASSWORD`).  \n   - Direct VNC access is available on port **5900**, mapped to container port **5901**.  \n   - This allows you to monitor all browser interactions in real time.\n\n5. **Container Management:**\n   ```bash\n   # Start with persistent browser\n   CHROME_PERSISTENT_SESSION=true docker compose up -d\n\n   # Start with default mode (browser closes after tasks)\n   docker compose up -d\n\n   # View logs\n   docker compose logs -f\n\n   # Stop the container\n   docker compose down\n   ```\n\n## Changelog\n- [x] **2025/01/26:** Thanks to @tiagonascimento31. Now Web Hive can combine with DeepSeek-r1 for enhanced AI capabilities!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebhiveos%2Fwebhive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebhiveos%2Fwebhive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebhiveos%2Fwebhive/lists"}