{"id":49720073,"url":"https://github.com/browser-use/bux","last_synced_at":"2026-06-04T13:30:31.967Z","repository":{"id":354045738,"uuid":"1221914096","full_name":"browser-use/bux","owner":"browser-use","description":"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.","archived":false,"fork":false,"pushed_at":"2026-05-25T20:38:30.000Z","size":7512,"stargazers_count":345,"open_issues_count":21,"forks_count":43,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-25T22:25:18.023Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://www.tiktok.com/@browser_use/video/7639824093721758989","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/browser-use.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-26T20:53:37.000Z","updated_at":"2026-05-25T13:25:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/browser-use/bux","commit_stats":null,"previous_names":["browser-use/bux"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/browser-use/bux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browser-use","download_url":"https://codeload.github.com/browser-use/bux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fbux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33907693,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-05-09T00:00:28.506Z","updated_at":"2026-06-04T13:30:31.962Z","avatar_url":"https://github.com/browser-use.png","language":"Python","funding_links":[],"categories":["Reference Implementations","🤖 Agents \u0026 Orchestration"],"sub_categories":["Demo Harnesses"],"readme":"# Browser Use Box ♞\n\n\u003cimg src=\"docs/hero.jpg\" alt=\"Browser Use Box hero\" width=\"100%\" /\u003e\n\n\n## Your 24/7 Claude Code agent with a real browser, on any box you own.\n\nRent 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.\n\n```\n$ curl -fsSL https://raw.githubusercontent.com/browser-use/bux/main/install.sh \\\n    | sudo BROWSER_USE_API_KEY=bu_xxx bash\n```\n\nThree minutes from a blank VPS to *\"hey claude, check my email and summarize the unread ones\"* via Telegram.\n\n[Watch the 14-second Browser Use Box demo on TikTok](https://www.tiktok.com/@browser_use/video/7639824093721758989).\n\nMore launch links:\n\n- [Public demo release](https://github.com/browser-use/bux/releases/tag/box-demo-2026-05-14)\n- [Pinned announcement discussion](https://github.com/browser-use/bux/discussions/181)\n- [Browser Use Box wiki](https://github.com/browser-use/bux/wiki)\n- [Launch page](https://browser-use.github.io/bux/)\n- [Managed pilot for Telegram-heavy teams](https://browser-use.github.io/bux/pilot.html)\n- [Managed pilot playbook](https://browser-use.github.io/bux/managed-pilot-playbook.html)\n- [Managed pilot demo transcript](https://browser-use.github.io/bux/managed-pilot-demo.html)\n- [Managed Telegram AI operator](https://browser-use.github.io/bux/telegram-ai-operator.html)\n- [Telegram AI operator for agencies](https://browser-use.github.io/bux/telegram-ai-operator-agencies.html)\n- [n8n Telegram AI operator](https://browser-use.github.io/bux/n8n-telegram-ai-operator.html)\n- [Telegram AI operator for crypto and fintech teams](https://browser-use.github.io/bux/telegram-operator-crypto.html)\n- [Managed pilot for AI automation agencies](https://browser-use.github.io/bux/managed-pilot-partners.html)\n- [Managed pilot proof report demo](https://browser-use.github.io/bux/managed-pilot-proof-report.html)\n- [Managed pilot terms](https://browser-use.github.io/bux/managed-pilot-terms.html)\n\n## Setup prompt\n\nPaste into Claude Code (on your laptop) and it will set up your VPS for you:\n\n```text\nSet up https://github.com/browser-use/bux on my remote box.\n\nSSH 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.\n```\n\n## What you get\n\n- **Claude Code** logged in and always on\n- A real **Chromium** session via [browser-harness](https://github.com/browser-use/browser-harness) — cookies persist, logins stick\n- A **Telegram bot** so you can text your agent — pass `TG_BOT_TOKEN=xxx` to the installer to enable\n- A **web terminal** bound to localhost for when SSH is too much\n- When claude hits a login wall / 2FA / CAPTCHA, it hands you a **live view URL** and waits — no credential-stuffing, no brittle workarounds\n\n## Requirements\n\n- **A box** — Ubuntu 22.04+ with ≥2GB RAM. A $5/mo VPS is fine.\n- **[Browser Use Cloud API key](https://cloud.browser-use.com/new-api-key)** — free tier: 3 concurrent browsers, proxies, CAPTCHA solving.\n- An Anthropic API key *or* Claude Max subscription (claude asks on first `/login`).\n- *(optional)* A Telegram bot token from [@BotFather](https://t.me/BotFather).\n\n## How it works\n\n```\n  telegram ──►  telegram_bot.py ─┐\n                                 ├──► claude -p  ──► browser-harness ──► BU Cloud\n  browser  ──►  ttyd ────────────┘         │            (cdp over wss)\n                                           ▼\n                                  /home/bux (persistent state)\n```\n\nThree small services under systemd. Agent state lives in `/home/bux`, so reboots keep your cookies, skills, and chat history.\n\n## Docs\n\n- [install.md](install.md) — full install guide and troubleshooting\n- [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.\n\n## Managed offering\n\nIf 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.\n\nFor 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.\n\nThe pilot scope, handoff format, and example operator rules are in the [managed pilot playbook](https://browser-use.github.io/bux/managed-pilot-playbook.html).\n\nThe [demo transcript](https://browser-use.github.io/bux/managed-pilot-demo.html) shows the first workflow: Telegram lead triage into a clean human handoff.\n\nThe [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.\n\nThe [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.\n\nThe [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.\n\nThe [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.\n\nThe [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.\n\nThe [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.\n\nThe [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.\n\nPilot 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).\n\n## Contributing\n\nPRs welcome — bug fixes, docs tweaks, and new features all appreciated. Open an issue first if you're planning something larger.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowser-use%2Fbux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowser-use%2Fbux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowser-use%2Fbux/lists"}