> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browseros.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BrowserOS

> The open-source AI browser that turns your words into actions

![BrowserOS in action](https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/images/hero-dark.png?fit=max\&auto=format\&n=SQ44qH9ZJeym2Wd9\&q=85\&s=83bfcf1d03529b58eab7dfb4910d4ad8)

BrowserOS is an AI-native browser that lets you automate any web task by describing it in plain English. Built on Chromium, it runs AI agents locally on your machine—keeping your data private while giving you superpowers for browsing.

**Open source. Privacy-first. The browser for the AI era.**

## Three Ways to Use AI

> [card] Chat Mode
>
> Ask questions about the page you're viewing. Summarize articles, extract data, translate content—without leaving the page.

> [card] Agent Mode
>
> Describe a task and watch AI execute it: clicking, typing, navigating. Automate form filling, data extraction, and multi-step workflows.

> [card] Graph Mode
>
> Build reliable, repeatable workflows as visual graphs. Edit steps, save, and run anytime. *Coming soon.*

## Quick Start

**1. Install BrowserOS**

On macOS, install with Homebrew. BrowserOS is in Homebrew's own cask repository, so there is no tap to add:

```sh theme={null}
brew install --cask browseros
```

Requires macOS 13 (Ventura) or later. Upgrade with `brew upgrade --cask browseros`, though the browser also updates itself.

On Windows and Linux, or on macOS without Homebrew, get the latest release from [browseros.com](https://browseros.com).

**2. Import from Chrome**

Navigate to `chrome://settings/importData` and import your bookmarks, passwords, and settings in one click.

**3. Configure your AI**

BrowserOS includes a default AI model with limited daily usage for testing. For the full experience, bring your own API keys.

> [card] [Set up your LLM provider](https://docs.browseros.com/browseros/features/bring-your-own-llm.md)
>
> Configure Gemini, Claude, OpenAI, or run models locally with Ollama

**4. Try it out**

Open any webpage and press the **Assistant** button in the toolbar. Ask a question about the page, or describe a task to automate.

## Which AI Model Should I Use?

> [tab] For Chat Mode
>
> **Any model works great**, including local LLMs.
>
> * **Ollama** or **LM Studio** — Free, runs locally, great for quick questions
> * **Gemini Flash** — Fast and affordable
> * **Claude or GPT-4** — Best quality responses
>
> Chat Mode just needs to understand the page and answer questions—local models handle this well.

> [tab] For Agent Mode
>
> **Use Claude Opus 4.5 for best results.**
>
> | Model | Speed | Quality |
> | - | - | - |
> | Claude Opus 4.5 | Slower | Best |
> | Claude Sonnet 4.5 | Medium | Great |
> | Claude Haiku 4.5 | Fast | Good |
> | Gemini Flash | Fast | Good |
>
> > [!WARNING]
> >
> > Local LLMs are not yet powerful enough for Agent Mode. The model needs strong reasoning to click the right elements and handle multi-step tasks.

## Why BrowserOS?

> [card] Privacy-First
>
> Run AI locally with Ollama, or bring your own API keys. Your browsing data never leaves your machine unless you choose.

> [card] Open Source
>
> 100% open source under AGPL-3.0. Inspect the code, contribute features, or fork it for your needs.

> [card] Works with Your Tools
>
> Built-in MCP servers for Gmail, Calendar, Docs, Sheets, Notion. Connect to Claude Code or Gemini CLI for developer workflows.

> [card] Chrome Compatible
>
> All your Chrome extensions work. Import bookmarks, passwords, and settings in one click.

## Community

> [card] [Discord](https://discord.gg/YKwjt5vuKr)
>
> Get help and share feedback

> [card] [GitHub](https://github.com/BrowserOS-ai/BrowserOS)
>
> Star us and contribute

> [card] [Twitter](https://x.com/browserOS_ai)
>
> Follow for updates


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.