Skip to content

Repository files navigation

github-banner



DiscordSlackLicense: AGPL v3Docs

Download for macOS (beta)Download for Windows (beta)Download for Linux (beta)Download Debian package

Founders — @nv_sonti and @ThatNithin:

Twitter FollowTwitter Follow

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

FeatureDescriptionDocs
AI Agent53+ browser automation tools — navigate, click, type, extract data, all with natural languageGuide
MCP ServerControl the browser from Claude Code, Gemini CLI, or any MCP clientSetup
WorkflowsBuild repeatable browser automations with a visual graph builderDocs
CoworkCombine browser automation with local file operations — research the web, save reports to your folderDocs
Scheduled TasksRun agents on autopilot — daily, hourly, or every few minutesDocs
MemoryPersistent memory across conversations — your assistant remembers context over timeDocs
SOUL.mdDefine your AI's personality and instructions in a single markdown fileDocs
LLM HubCompare Claude, ChatGPT, and Gemini responses side-by-side on any pageDocs
40+ App IntegrationsGmail, Slack, GitHub, Linear, Notion, Figma, Salesforce, and more via MCPDocs
Vertical TabsSide-panel tab management — stay organized even with 100+ tabs openDocs
Ad BlockinguBlock Origin + Manifest V2 support — 10x more protection than ChromeDocs
Cloud SyncSync browser config and agent history across devicesDocs
SkillsCustom instruction sets that shape how your AI assistant behavesDocs
Smart NudgesContextual suggestions to connect apps and use features at the right momentDocs

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.

ProviderTypeAuth
Kimi K2.5Cloud (default)Built-in
ChatGPT Pro/PlusCloudOAuth
GitHub CopilotCloudOAuth
Qwen CodeCloudOAuth
Claude (Anthropic)CloudAPI key
GPT-4o / o3 (OpenAI)CloudAPI key
Gemini (Google)CloudAPI key
Azure OpenAICloudAPI key
AWS BedrockCloudIAM credentials
OpenRouterCloudAPI key
OllamaLocalSetup
LM StudioLocalSetup

How We Compare

BrowserOSChromeBraveDiaCometAtlas
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
PackageWhat it does
packages/browserosChromium fork — patches, build system, signing
apps/serverBun server exposing 53+ MCP tools and running the AI agent loop
apps/agentBrowser extension — new tab, side panel chat, onboarding, settings
apps/cliGo CLI — control BrowserOS from the terminal or AI coding agents
apps/evalBenchmark framework — WebVoyager, Mind2Web evaluation
agent-sdkNode.js SDK for browser automation with natural language
cdp-protocolType-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.

Citation

If you use BrowserOS in your research or project, please cite:

@software{browseros2025,
author = {Nithin Sonti and Nikhil Sonti and {BrowserOS-team}},
title = {BrowserOS: The open-source Agentic browser},
url = {https://github.com/browseros-ai/BrowserOS},
year = {2025},
publisher = {GitHub},
license = {AGPL-3.0},
}

License

BrowserOS is open source under the AGPL-3.0 license.

Copyright © 2026 Felafax, Inc.

Stargazers

Thank you to all our supporters!

Star History Chart

Built with ❤️ from San Francisco

About

🌐 The open-source Agentic browser; alternative to ChatGPT Atlas, Perplexity Comet, Dia.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages