Skip to content

browseros-ai/BrowserOS

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

BrowserOS agent in action

Install BrowserOS as MCP and control it from claude-code

HackerNews.top.3.mp4



Use BrowserOS to chat

use-browserOS-to-chat.mp4



Use BrowserOS to scrape data

use-browserOS-to-extract.mp4



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:

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.

Agent development (TypeScript/Go) β€” see the agent monorepo README for setup instructions.

Browser development (C++/Python) β€” requires ~100GB disk space. See packages/browseros for build instructions.

Credits

  • ungoogled-chromium β€” BrowserOS uses some patches for enhanced privacy. Thanks to everyone behind this project!
  • The Chromium Project β€” at the core of BrowserOS, making it possible to exist in the first place.

License

BrowserOS is open source under the AGPL-3.0 license.

Copyright Β© 2025 Felafax, Inc.

Stargazers

Thank you to all our supporters!

Star History Chart

Built with ❀️ from San Francisco