BrowserOS

<div align="center"> <img width="693" height="379" alt="github-banner" src="https://github.com/user-attachments/assets/1e37941c-4dbc-4662-9c8c-3bbe9971301d" />

<br></br> <br></br> <a href="https://files.browseros.com/download/BrowserOS.dmg"> <img src="https://img.shields.io/badge/Download-macOS-black?style=flat&logo=apple&logoColor=white" alt="Download for macOS (beta)" /> </a> <a href="https://files.browseros.com/download/BrowserOS_installer.exe"> <img src="https://img.shields.io/badge/Download-Windows-0078D4?style=flat&logo=windows&logoColor=white" alt="Download for Windows (beta)" /> </a> <a href="https://files.browseros.com/download/BrowserOS.AppImage"> <img src="https://img.shields.io/badge/Download-Linux-FCC624?style=flat&logo=linux&logoColor=black" alt="Download for Linux (beta)" /> </a> <a href="https://cdn.browseros.com/download/BrowserOS.deb"> <img src="https://img.shields.io/badge/Download-Debian-D70A53?style=flat&logo=debian&logoColor=white" alt="Download Debian package" /> </a> <br />

</div>

BrowserOS is an open-source Chromium fork that runs AI agents natively. The privacy-first alternative to ChatGPT Atlas, Perplexity Comet, and Dia.

Use your own API keys or run local models with Ollama. Your data never leaves your machine.

Documentation · Discord · Slack · Twitter · Feature Requests

Quick Start

1. Download and install BrowserOS — macOS · Windows · Linux (AppImage) · Linux (Debian)
2. Import your Chrome data (optional) — bookmarks, passwords, extensions all carry over
3. Connect your AI provider — Claude, OpenAI, Gemini, ChatGPT Pro via OAuth, or local models via Ollama/LM Studio

Features

| Feature | Description | Docs | |---------|-------------|------| | AI Agent | 53+ browser automation tools — navigate, click, type, extract data, all with natural language | Guide | | MCP Server | Control the browser from Claude Code, Gemini CLI, or any MCP client | Setup | | Workflows | Build repeatable browser automations with a visual graph builder | Docs | | Cowork | Combine browser automation with local file operations — research the web, save reports to your folder | Docs | | Scheduled Tasks | Run agents on autopilot — daily, hourly, or every few minutes | Docs | | Memory | Persistent memory across conversations — your assistant remembers context over time | Docs | | SOUL.md | Define your AI's personality and instructions in a single markdown file | Docs | | LLM Hub | Compare Claude, ChatGPT, and Gemini responses side-by-side on any page | Docs | | 40+ App Integrations | Gmail, Slack, GitHub, Linear, Notion, Figma, Salesforce, and more via MCP | Docs | | Vertical Tabs | Side-panel tab management — stay organized even with 100+ tabs open | Docs | | Ad Blocking | uBlock Origin + Manifest V2 support — 10x more protection than Chrome | Docs | | Cloud Sync | Sync browser config and agent history across devices | Docs | | Skills | Custom instruction sets that shape how your AI assistant behaves | Docs | | Smart Nudges | Contextual suggestions to connect apps and use features at the right moment | Docs |

Demos

BrowserOS agent in action

<br/><br/>

Install BrowserOS as MCP and control it from claude-code

https://github.com/user-attachments/assets/c725d6df-1a0d-40eb-a125-ea009bf664dc

<br/><br/>

Use BrowserOS to chat

https://github.com/user-attachments/assets/726803c5-8e36-420e-8694-c63a2607beca

<br/><br/>

Use BrowserOS to scrape data

https://github.com/user-attachments/assets/9f038216-bc24-4555-abf1-af2adcb7ebc0

<br/><br/>

Install browseros-cli

Use browseros-cli to launch and control BrowserOS from the terminal or from AI coding agents like Claude Code.

macOS / Linux:

curl -fsSL https://cdn.browseros.com/cli/install.sh | bash

Windows:

irm https://cdn.browseros.com/cli/install.ps1 | iex

After install, run browseros-cli init to connect the CLI to your running BrowserOS instance.

LLM Providers

BrowserOS works with any LLM. Bring your own keys, use OAuth, or run models locally.

| Provider | Type | Auth | |----------|------|------| | Kimi K2.5 | Cloud (default) | Built-in | | ChatGPT Pro/Plus | Cloud | OAuth | | GitHub Copilot | Cloud | OAuth | | Qwen Code | Cloud | OAuth | | Claude (Anthropic) | Cloud | API key | | GPT-4o / o3 (OpenAI) | Cloud | API key | | Gemini (Google) | Cloud | API key | | Azure OpenAI | Cloud | API key | | AWS Bedrock | Cloud | IAM credentials | | OpenRouter | Cloud | API key | | Ollama | Local | Setup | | LM Studio | Local | Setup |

How We Compare

| | BrowserOS | Chrome | Brave | Dia | Comet | Atlas | |---|:---:|:---:|:---:|:---:|:---:|:---:| | Open Source | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | | AI Agent | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | | MCP Server | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | | Visual Workflows | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | | Cowork (files + browser) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | | Scheduled Tasks | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | | Bring Your Own Keys | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | | Local Models (Ollama) | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | | Local-first Privacy | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | | Ad Blocking (MV2) | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ |

Detailed comparisons:

• BrowserOS vs Chrome DevTools MCP — developer-focused comparison for browser automation
• BrowserOS vs Claude Cowork — getting real work done with AI
• BrowserOS vs OpenClaw — everyday AI assistance

Architecture

BrowserOS is a monorepo with two main subsystems: the browser (Chromium fork) and the agent platform (TypeScript/Go).

BrowserOS/
├── packages/browseros/              # Chromium fork + build system (Python)
│   ├── chromium_patches/            # Patches applied to Chromium source
│   ├── build/                       # Build CLI and modules
│   └── resources/                   # Icons, entitlements, signing
│
├── packages/browseros-agent/        # Agent platform (TypeScript/Go)
│   ├── apps/
│   │   ├── server/                  # MCP server + AI agent loop (Bun)
│   │   ├── agent/                   # Browser extension UI (WXT + React)
│   │   ├── cli/                     # CLI tool (Go)
│   │   ├── eval/                    # Benchmark framework
│   │   └── controller-ext/          # Chrome API bridge extension
│   │
│   └── packages/
│       ├── agent-sdk/               # Node.js SDK (npm: @browseros-ai/agent-sdk)
│       ├── cdp-protocol/            # CDP type bindings
│       └── shared/                  # Shared constants

| Package | What it does | |---------|-------------| | packages/browseros | Chromium fork — patches, build system, signing | | apps/server | Bun server exposing 53+ MCP tools and running the AI agent loop | | apps/agent | Browser extension — new tab, side panel chat, onboarding, settings | | apps/cli | Go CLI — control BrowserOS from the terminal or AI coding agents | | apps/eval | Benchmark framework — WebVoyager, Mind2Web evaluation | | agent-sdk | Node.js SDK for browser automation with natural language | | cdp-protocol | Type-safe Chrome DevTools Protocol bindings |

Contributing

We'd love your help making BrowserOS better! See our Contributing Guide for details.

• Report bugs
• Suggest features
• Join Discord · [Join Slack](https://dub.sh/browserOS