# Browser Use Box ♞

<img src="docs/hero.jpg" alt="Browser Use Box hero" width="100%" />


## 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
```

More launch links:
- [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).