https://github.com/browser-use/bux
Browser Use Box: a 24/7 Claude Code agent for Playwright-style browser automation with Browser Use Cloud, Telegram, and a real browser on any box you own.
https://github.com/browser-use/bux
ai-agent ai-automation automation browser-agent browser-automation browser-use browser-use-box browser-use-cloud claude-code claude-code-agent cloud-browser persistent-browser playwright playwright-automation telegram-agent telegram-automation telegram-bot vps vps-agent web-automation
Last synced: 9 days ago
JSON representation
Browser Use Box: a 24/7 Claude Code agent for Playwright-style browser automation with Browser Use Cloud, Telegram, and a real browser on any box you own.
- Host: GitHub
- URL: https://github.com/browser-use/bux
- Owner: browser-use
- License: mit
- Created: 2026-04-26T20:53:37.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-25T20:38:30.000Z (19 days ago)
- Last Synced: 2026-05-25T22:25:18.023Z (19 days ago)
- Topics: ai-agent, ai-automation, automation, browser-agent, browser-automation, browser-use, browser-use-box, browser-use-cloud, claude-code, claude-code-agent, cloud-browser, persistent-browser, playwright, playwright-automation, telegram-agent, telegram-automation, telegram-bot, vps, vps-agent, web-automation
- Language: Python
- Homepage: https://www.tiktok.com/@browser_use/video/7639824093721758989
- Size: 7.16 MB
- Stars: 345
- Watchers: 1
- Forks: 43
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-harness-engineering - bux - native coding agent with live browser automation for workflows that span API documentation, web-based configuration, and headless verification — the reference for unattended agents that need both shell and browser surfaces.  (Reference Implementations / Demo Harnesses)
- awesome-claude-code - **bux** - A 24/7 Claude Code agent with Browser Harness, on any box you own. (🤖 Agents & Orchestration)
README
# Browser Use Box ♞
## Your 24/7 Claude Code agent with a real browser, on any box you own.
Rent any $5 VPS (Hetzner, DigitalOcean, Mac mini, Raspberry Pi — anything that runs Ubuntu), point one install script at it, and text your agent from anywhere.
```
$ curl -fsSL https://raw.githubusercontent.com/browser-use/bux/main/install.sh \
| sudo BROWSER_USE_API_KEY=bu_xxx bash
```
Three minutes from a blank VPS to *"hey claude, check my email and summarize the unread ones"* via Telegram.
[Watch the 14-second Browser Use Box demo on TikTok](https://www.tiktok.com/@browser_use/video/7639824093721758989).
More launch links:
- [Public demo release](https://github.com/browser-use/bux/releases/tag/box-demo-2026-05-14)
- [Pinned announcement discussion](https://github.com/browser-use/bux/discussions/181)
- [Browser Use Box wiki](https://github.com/browser-use/bux/wiki)
- [Launch page](https://browser-use.github.io/bux/)
- [Managed pilot for Telegram-heavy teams](https://browser-use.github.io/bux/pilot.html)
- [Managed pilot playbook](https://browser-use.github.io/bux/managed-pilot-playbook.html)
- [Managed pilot demo transcript](https://browser-use.github.io/bux/managed-pilot-demo.html)
- [Managed Telegram AI operator](https://browser-use.github.io/bux/telegram-ai-operator.html)
- [Telegram AI operator for agencies](https://browser-use.github.io/bux/telegram-ai-operator-agencies.html)
- [n8n Telegram AI operator](https://browser-use.github.io/bux/n8n-telegram-ai-operator.html)
- [Telegram AI operator for crypto and fintech teams](https://browser-use.github.io/bux/telegram-operator-crypto.html)
- [Managed pilot for AI automation agencies](https://browser-use.github.io/bux/managed-pilot-partners.html)
- [Managed pilot proof report demo](https://browser-use.github.io/bux/managed-pilot-proof-report.html)
- [Managed pilot terms](https://browser-use.github.io/bux/managed-pilot-terms.html)
## Setup prompt
Paste into Claude Code (on your laptop) and it will set up your VPS for you:
```text
Set up https://github.com/browser-use/bux on my remote box.
SSH into it (I'll paste the host below), run install.sh with my BROWSER_USE_API_KEY, and optionally wire up a Telegram bot if I give you a token from @BotFather. Read install.md first. After the install completes, verify the services are running (systemctl is-active bux-browser-keeper bux-ttyd), then become the `bux` user and run `claude /login` so I can complete the OAuth flow. Once logged in, test the setup by asking claude to visit https://browser-use.com and report the page title.
```
## What you get
- **Claude Code** logged in and always on
- A real **Chromium** session via [browser-harness](https://github.com/browser-use/browser-harness) — cookies persist, logins stick
- A **Telegram bot** so you can text your agent — pass `TG_BOT_TOKEN=xxx` to the installer to enable
- A **web terminal** bound to localhost for when SSH is too much
- When claude hits a login wall / 2FA / CAPTCHA, it hands you a **live view URL** and waits — no credential-stuffing, no brittle workarounds
## Requirements
- **A box** — Ubuntu 22.04+ with ≥2GB RAM. A $5/mo VPS is fine.
- **[Browser Use Cloud API key](https://cloud.browser-use.com/new-api-key)** — free tier: 3 concurrent browsers, proxies, CAPTCHA solving.
- An Anthropic API key *or* Claude Max subscription (claude asks on first `/login`).
- *(optional)* A Telegram bot token from [@BotFather](https://t.me/BotFather).
## How it works
```
telegram ──► telegram_bot.py ─┐
├──► claude -p ──► browser-harness ──► BU Cloud
browser ──► ttyd ────────────┘ │ (cdp over wss)
▼
/home/bux (persistent state)
```
Three small services under systemd. Agent state lives in `/home/bux`, so reboots keep your cookies, skills, and chat history.
## Docs
- [install.md](install.md) — full install guide and troubleshooting
- [agent/CLAUDE.md](agent/CLAUDE.md) — the context claude loads on every session. Edit it to customize behavior (working dir layout, skill policies, allowed tools), then rerun `install.sh` — it's idempotent and the next claude turn picks up the change.
## Managed offering
If you'd rather not run your own VPS: [cloud.browser-use.com](https://cloud.browser-use.com) provisions a box for you in ~60s — same software, zero setup, one-command `bux up` via a Claude Code skill.
For teams that already run sales, support, partner onboarding, or operations in Telegram, there is also a [$1,000/month managed pilot](https://browser-use.github.io/bux/pilot.html): one scoped private operator workflow, launched in 7 days, with human handoff and weekly tuning.
The pilot scope, handoff format, and example operator rules are in the [managed pilot playbook](https://browser-use.github.io/bux/managed-pilot-playbook.html).
The [demo transcript](https://browser-use.github.io/bux/managed-pilot-demo.html) shows the first workflow: Telegram lead triage into a clean human handoff.
The [managed Telegram AI operator page](https://browser-use.github.io/bux/telegram-ai-operator.html) is the focused entry point for lead qualification, support triage, and partner onboarding use cases.
The [Telegram AI operator for agencies page](https://browser-use.github.io/bux/telegram-ai-operator-agencies.html) gives AI automation agencies a managed implementation path for one Telegram-heavy client workflow.
The [n8n Telegram AI operator page](https://browser-use.github.io/bux/n8n-telegram-ai-operator.html) gives n8n builders a managed Telegram-first operator that hands off cleanly into existing workflows and human approvals.
The [Telegram AI operator for crypto and fintech teams](https://browser-use.github.io/bux/telegram-operator-crypto.html) packages the same managed pilot for partner, support, ecosystem, and ops teams that triage Telegram requests by hand.
The [partner pilot page](https://browser-use.github.io/bux/managed-pilot-partners.html) packages the same $1,000/month workflow as a delivery layer for AI automation agencies with Telegram-heavy clients.
The [proof report demo](https://browser-use.github.io/bux/managed-pilot-proof-report.html) shows the weekly artifact that makes the retainer easy to renew: handled threads, clean handoffs, checks completed, blockers, tuning, and estimated time saved.
The [managed pilot terms](https://browser-use.github.io/bux/managed-pilot-terms.html) summarize the $1,000/month scope, first-week deliverables, and acceptance criteria.
Pilot inquiries can start on [Telegram](https://t.me/Magnus_Mueller) or through the [managed pilot issue form](https://github.com/browser-use/bux/issues/new?template=managed-pilot.yml).
## Contributing
PRs welcome — bug fixes, docs tweaks, and new features all appreciated. Open an issue first if you're planning something larger.
## License
MIT. See [LICENSE](LICENSE).