nanobrowser/nanobrowser

🌐 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!

🔥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, DeepSeek, Grok, Azure OpenAI, OpenRouter, Ollama 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

1. 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.

2. 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:

1. Download

• Download the latest nanobrowser.zip file from the official Github release page.

2. Install:

• Unzip nanobrowser.zip.
• Open chrome://extensions/ in Chrome
• Enable Developer mode (top right)
• Click Load unpacked (top left)
• Select the unzipped nanobrowser folder.

3. 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)

4. 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:

1. Prerequisites:

• Node.js 24 LTS (v24.11.0 or higher)
• pnpm (v10 or newer; switches to the pinned v10.34.6 automatically)

2. Clone the Repository:

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

3. Install Dependencies:

   corepack enable # skip if pnpm 10+ is already installed
   pnpm install
   

4. Build the Extension (WXT, Chromium Manifest V3):

   pnpm build
   

5. 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

6. Development Mode (optional):

   pnpm dev
   

Load dist/ unpacked manually in Chrome or Edge. WXT updates pages with HMR and reloads the extension for background/content changes. Keep using the same dist/ path to preserve your local extension ID and stored settings.

pnpm zip builds a production archive in dist-zip/ for Chrome and Edge.

🤖 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 5.5
• Better reasoning and planning capabilities
• Navigator: Claude Haiku 4.5
• Efficient for web navigation tasks
• Good balance of performance and cost

Cost-Effective Configuration

• Planner: Claude Haiku 4.5 or Gemini 3.8 Flash
• Reasonable performance at lower cost
• May require more iterations for complex tasks
• Navigator: Gemini 3.5 Flash-Lite
• 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:

1. News Summary: > "Go to TechCrunch and extract top 10 headlines from the last 24 hours"

2. GitHub Research: > "Look for the trending Python repositories on GitHub with most stars"

3. 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 to address the issue before it's publicly disclosed.

We appreciate your help in keeping Nanobrowser and its users safe!

💬 Community

Join our growing community of developers and users:

• Discord - Chat with team and community
• Twitter - Follow for updates and announcements
• GitHub Discussions - Share ideas and ask questions

👏 Acknowledgments

Nanobrowser builds on top of other awesome open-source projects:

• Browser Use
• Puppeteer
• WXT
• Chrome Extension Boilerplate (the original build foundation)
• Vercel AI SDK

Huge thanks to their creators and contributors!

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Made with ❤️ by the Nanobrowser Team.

Like Nanobrowser? Give us a star 🌟 and join us in Discord | X

🔗 Our Other Products

• DSH Plugin Directory: Discover installable community plugins for DeepSeek Harness by category, popularity, and activity.

⚠️ DISCLAIMER ON DERIVATIVE PROJECTS

**We explicitly DO NOT endorse, support, or participate in any projects involving cryptocurrencies, tokens, NFTs, or other blockchain-related applications based on this codebase.

Any such derivative projects are NOT Affiliated with, or maintained by, or in any way connected to the official Nanobrowser project or its core team.

We assume NO LIABILITY for any losses, damages, or issues arising from the use of third-party derivative projects. Users interact with these projects at their own risk.

We reserve the right to publicly distance ourselves from any misuse or misleading use of our name, codebase, or brand.**

We encourage open-source innovation but urge our community to be discerning and cautious. Please ensure you understand the risks before using any software or service built upon our codebase by independent developers.