A 24/7 Claude Code agent with a real browser, deployable on user-owned infrastructure like affordable VPS instances or personal hardware. It targets users needing AI agents capable of dynamic web interaction, persistent sessions, and authentication handling, offering a flexible, user-controlled alternative to cloud-based solutions.

How It Works

Three systemd services run on an Ubuntu host: Claude Code, Browser Harness (managing persistent Chromium sessions with cookies/logins), and a Telegram bot for interaction. A ttyd web terminal is also provided. When encountering login walls or CAPTCHAs, the agent pauses, offering a live URL for user resolution, avoiding brittle automation. Agent state, including session data, persists in /home/bux.

Quick Start & Requirements

Install via: curl -fsSL https://raw.githubusercontent.com/browser-use/bux/main/install.sh | sudo BROWSER_USE_API_KEY=bu_xxx bash.

• Prerequisites: Ubuntu 22.04+ (≥2GB RAM), Browser Use Cloud API key (free tier available), Anthropic API key/Claude Max subscription. Optional Telegram bot token.
• Setup Time: Approximately 3 minutes.
• Docs: Full installation and usage details are in install.md, agent context in agent/CLAUDE.md, and provider-specific recipes in docs/recipes/.

Highlighted Details

• Provides a 24/7 AI agent with a persistent, real Chromium browser session, retaining cookies and login states across reboots.
• Facilitates remote control and interaction through an integrated Telegram bot.
• Includes a ttyd-based web terminal for direct access when SSH is less convenient.
• Handles complex authentication scenarios (login walls, 2FA, CAPTCHAs) by pausing execution and providing a live view URL for user intervention.

Maintenance & Community

Contributions via Pull Requests are welcomed, particularly for provider-specific deployment recipes. A managed, zero-setup offering is available via cloud.browser-use.com. Specific community channels (e.g., Discord, Slack) or a public roadmap are not detailed in the README.

Licensing & Compatibility

The project is released under the MIT license, which generally permits broad use, including commercial applications and integration with closed-source software.

Limitations & Caveats

Requires users to provision and manage their own Ubuntu-based infrastructure. Dependency on external API keys (Browser Use Cloud, Anthropic) is necessary for full functionality. The system requires manual user intervention for resolving complex authentication challenges via provided URLs.