</div>

🌐 Nanobrowser

Nanobrowser is an open-source AI web automation tool that runs in your browser. A free alternative to OpenAI Operator with flexible LLM options and multi-agent system.

⬇️ Get Nanobrowser from Chrome Web Store for free

👏 Join the community in Discord | X

🌟 Loving Nanobrowser? Give us a star and help spread the word!

❤️ Support the project by sponsoring us - every contribution helps keep Nanobrowser free and open source!

<div align="center"> <img src="https://github.com/user-attachments/assets/112c4385-7b03-4b81-a352-4f348093351b" width="600" alt="Nanobrowser Demo GIF" /> <p><em>Nanobrowser's multi-agent system analyzing HuggingFace in real-time, with the Planner intelligently self-correcting when encountering obstacles and dynamically instructing the Navigator to adjust its approach—all running locally in your browser.</em></p> </div>

🔥Why Nanobrowser?

Looking for a powerful AI browser agent without the $200/month price tag of OpenAI Operator? Nanobrowser , as a chrome extension, delivers premium web automation capabilities while keeping you in complete control:

100% Free - No subscription fees or hidden costs. Just install and use your own API keys, and you only pay what you use with your own API keys.
Privacy-Focused - Everything runs in your local browser. Your credentials stay with you, never shared with any cloud service.
Flexible LLM Options - Connect to your preferred LLM providers with the freedom to choose different models for different agents.
Fully Open Source - Complete transparency in how your browser is automated. No black boxes or hidden processes.

Note: We currently support OpenAI, Anthropic, Gemini, Ollama, Groq, Cerebras, Llama and custom OpenAI-Compatible providers, more providers will be supported.

📊 Key Features

Multi-agent System: Specialized AI agents collaborate to accomplish complex web workflows
Interactive Side Panel: Intuitive chat interface with real-time status updates
Task Automation: Seamlessly automate repetitive web automation tasks across websites
Follow-up Questions: Ask contextual follow-up questions about completed tasks
Conversation History: Easily access and manage your AI agent interaction history
Multiple LLM Support: Connect your preferred LLM providers and assign different models to different agents

🌐 Browser Support

Officially Supported:

Chrome - Full support with all features
Edge - Full support with all features

Not Supported:

Firefox, Safari, and other Chromium variants (Opera, Arc, etc.)

Note: While Nanobrowser may function on other Chromium-based browsers, we recommend using Chrome or Edge for the best experience and guaranteed compatibility.

🚀 Quick Start

Install from Chrome Web Store (Stable Version):
- Visit the Nanobrowser Chrome Web Store page
- Click "Add to Chrome" button
- Confirm the installation when prompted

Important Note: For latest features, install from "Manually Install Latest Version" below, as Chrome Web Store version may be delayed due to review process.

Configure Agent Models:
- Click the Nanobrowser icon in your toolbar to open the sidebar
- Click the Settings icon (top right)
- Add your LLM API keys
- Choose which model to use for different agents (Navigator, Planner)

🔧 Manually Install Latest Version

To get the most recent version with all the latest features:

Download
- Download the latest nanobrowser.zip file from the official Github release page.
Install:
- Unzip nanobrowser.zip.
- Open chrome://extensions/ in Chrome
- Enable Developer mode (top right)
- Click Load unpacked (top left)
- Select the unzipped nanobrowser folder.
Configure Agent Models
- Click the Nanobrowser icon in your toolbar to open the sidebar
- Click the Settings icon (top right).
- Add your LLM API keys.
- Choose which model to use for different agents (Navigator, Planner)
Upgrading:
- Download the latest nanobrowser.zip file from the release page.
- Unzip and replace your existing Nanobrowser files with the new ones.
- Go to chrome://extensions/ in Chrome and click the refresh icon on the Nanobrowser card.

🛠️ Build from Source

If you prefer to build Nanobrowser yourself, follow these steps:

Prerequisites:
- Node.js (v22.12.0 or higher)
- pnpm (v9.15.1 or higher)

Clone the Repository:

git clone https://github.com/nanobrowser/nanobrowser.git
cd nanobrowser

Install Dependencies:
```
pnpm install
```
Build the Extension:
```
pnpm build
```
Load the Extension:
- The built extension will be in the dist directory
- Follow the installation steps from the Manually Install section to load the extension into your browser
Development Mode (optional):
```
pnpm dev
```

🤖 Choosing Your Models

Nanobrowser allows you to configure different LLM models for each agent to balance performance and cost. Here are recommended configurations:

Better Performance

Planner: Claude Sonnet 4
- Better reasoning and planning capabilities
Navigator: Claude Haiku 3.5
- Efficient for web navigation tasks
- Good balance of performance and cost

Cost-Effective Configuration

Planner: Claude Haiku or GPT-4o
- Reasonable performance at lower cost
- May require more iterations for complex tasks
Navigator: Gemini 2.5 Flash or GPT-4o-mini
- Lightweight and cost-efficient
- Suitable for basic navigation tasks

Local Models

Setup Options:
- Use Ollama or other custom OpenAI-compatible providers to run models locally
- Zero API costs and complete privacy with no data leaving your machine
Recommended Models:
- Qwen3-30B-A3B-Instruct-2507
- Falcon3 10B
- Qwen 2.5 Coder 14B
- Mistral Small 24B
- Latest test results from community
- We welcome community experience sharing with other local models in our Discord
Prompt Engineering:
- Local models require more specific and cleaner prompts
- Avoid high-level, ambiguous commands
- Break complex tasks into clear, detailed steps
- Provide explicit context and constraints

Note: The cost-effective configuration may produce less stable outputs and require more iterations for complex tasks.

Tip: Feel free to experiment with your own model configurations! Found a great combination? Share it with the community in our Discord to help others optimize their setup.

💡 See It In Action

Here are some powerful tasks you can accomplish with just a sentence:

News Summary:

"Go to TechCrunch and extract top 10 headlines from the last 24 hours"
GitHub Research:

"Look for the trending Python repositories on GitHub with most stars"
Shopping Research:

"Find a portable Bluetooth speaker on Amazon with a water-resistant design, under $50. It should have a minimum battery life of 10 hours"

🛠️ Roadmap

We're actively developing Nanobrowser with exciting features on the horizon, welcome to join us!

Check out our detailed roadmap and upcoming features in our GitHub Discussions.

🤝 Contributing

We need your help to make Nanobrowser even better! Contributions of all kinds are welcome:

Share Prompts & Use Cases
- Join our Discord server.
- share how you're using Nanobrowser. Help us build a library of useful prompts and real-world use cases.
Provide Feedback
- Try Nanobrowser and give us feedback on its performance or suggest improvements in our Discord server.
Contribute Code
- Check out our CONTRIBUTING.md for guidelines on how to contribute code to the project.
- Submit pull requests for bug fixes, features, or documentation improvements.

We believe in the power of open source and community collaboration. Join us in building the future of web automation!

🔒 Security

If you discover a security vulnerability, please DO NOT disclose it publicly through issues, pull requests, or discussions.

Instead, please create a GitHub Security Advisory to report the vulnerability responsibly. This allows us

Nanobrowser

Install / Use

README