Install

Nanobrowser is a Chrome extension. There is no npm package or CLI to install.

Option 1: Chrome Web Store (recommended, stable)

1. Open Chrome and go to the Nanobrowser listing on the Chrome Web Store:

   https://chromewebstore.google.com/detail/nanobrowser/imbddededgmcgfhfpcjmijokokekbkal

2. Click Add to Chrome.
3. Confirm the permissions prompt.
4. The Nanobrowser sidebar icon appears in the Chrome toolbar.

Option 2: Manual install from GitHub release (latest features)

1. Download the latest nanobrowser.zip from GitHub releases:

   https://github.com/nanobrowser/nanobrowser/releases

2. Unzip the file to a local folder.
3. Open chrome://extensions/ in Chrome.
4. Enable Developer mode (toggle, top right).
5. Click Load unpacked and select the unzipped folder.
6. The extension loads immediately.

Option 3: Build from source

Requirements: Node.js v22.12.0+ and pnpm v9.15.1+

git clone https://github.com/nanobrowser/nanobrowser.git
cd nanobrowser
pnpm install
pnpm build

Then load the dist/ folder via Load unpacked as in Option 2.

Post-install configuration

After any install method:

1. Click the Nanobrowser icon in the Chrome toolbar to open the sidebar.
2. Click Settings.
3. Add at least one LLM API key (OpenAI, Anthropic, Gemini, Ollama, Groq, Cerebras, or compatible).
4. Assign a model to each agent role (Navigator, Planner, Validator). GPT-4o or Claude 3.5 Sonnet work well for all three.
5. Save. The extension is ready.

Note: Nanobrowser does not store your API keys on any server. They are saved locally in Chrome's extension storage.