Browser Use Box ♞

A 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.

Setup prompt

Paste into Claude Code (on your laptop) and it will set up your VPS for you:

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 — 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 — 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.

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 — full install guide, troubleshooting, recipes
• agent/CLAUDE.md — the context claude loads on every session
• docs/recipes/ — provider-specific deploy notes

Managed offering

If you'd rather not run your own VPS: cloud.browser-use.com provisions a box for you in ~60s — same software, zero setup, one-command bux up via a Claude Code skill.

Contributing

PRs welcome — deploy recipes are the highest-leverage contribution (one .md per provider). Bug fixes and docs tweaks equally welcome.

License

MIT. See LICENSE.