Browser Use Box ♞

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 AGENTPHONE_API_KEY=sk_live_xxx bash

Three minutes from a blank VPS to "hey claude, check my email and summarize the unread ones" — just text your agent's phone number.

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 AGENTPHONE_API_KEY. Read install.md first. After the install completes, verify the services are running (systemctl is-active bux-browser-keeper bux-ttyd bux-sms), 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.

• Claude Code logged in and always on
• A real Chromium session via browser-harness — cookies persist, logins stick
• A real phone number via AgentPhone — text your agent, make calls, and 2FA is handled automatically. No Telegram needed.
• A web terminal bound to localhost for when SSH is too much
• (optional) A Telegram bot as an alternative channel — pass TG_BOT_TOKEN=xxx to the installer
• When claude hits a login wall / CAPTCHA, it hands you a live view URL and waits — no credential-stuffing, no brittle workarounds

• 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.
• AgentPhone API key — gives the agent a real phone number. Text it to give your agent work, and it handles 2FA automatically.
• An Anthropic API key or Claude Max subscription (claude asks on first /login).
• (optional) A Telegram bot token from @BotFather — alternative to SMS.

  SMS/call ──►  sms_bot.py ──────┐
                                 ├──► claude -p  ──► browser-harness ──► BU Cloud
  browser  ──►  ttyd ────────────┘         │            (cdp over wss)
                                           │
                                           ├──► agentphone CLI ──► AgentPhone API
                                           │    (2FA codes, outbound calls, SMS)
                                           ▼
                                  /home/bux (persistent state)

Three small services under systemd (bux-browser-keeper, bux-sms, bux-ttyd). Agent state lives in /home/bux, so reboots keep your cookies, skills, and chat history. Telegram (bux-tg) is available as an optional alternative channel.

• install.md — full install guide, troubleshooting, recipes
• agent/CLAUDE.md — the context claude loads on every session
• docs/recipes/ — provider-specific deploy notes

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.

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

MIT. See LICENSE.