Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/nanobrowser/nanobrowser

Open-Source Chrome extension for AI-powered web automation. Run multi-agent workflows using your own LLM API key. Alternative to OpenAI Operator.
https://github.com/nanobrowser/nanobrowser

agent ai ai-agents ai-tools automation browser-extension browser-use chrome-extension computer-use gpt-operator javascript manus multi-agent openai opensource operator web-agent web-automation

Last synced: 12 days ago
JSON representation

Open-Source Chrome extension for AI-powered web automation. Run multi-agent workflows using your own LLM API key. Alternative to OpenAI Operator.

Awesome Lists containing this project

README 

        


    banner








[![GitHub](https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/nanobrowser)

[![Twitter](https://img.shields.io/badge/Twitter-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/nanobrowser_ai)

[![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/NN3ABHggMK)






## 🌐 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](https://chromewebstore.google.com/detail/nanobrowser/imbddededgmcgfhfpcjmijokokekbkal) for free



👏 Join the community in [Discord](https://discord.gg/NN3ABHggMK) | [X](https://x.com/nanobrowser_ai)



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





Nanobrowser Demo GIF

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.





## 🔥Why Nanobrowser?



Looking for a powerful AI web 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 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



## 🚀 Quick Start



1. **Install from Chrome Web Store** (Stable Version):

   * Visit the [Nanobrowser Chrome Web Store page](https://chromewebstore.google.com/detail/nanobrowser/imbddededgmcgfhfpcjmijokokekbkal)

   * Click "Add to Chrome" button

   * Confirm the installation when prompted



> **Important Note**: For latest features, install from ["Manually Install Latest Version"](#-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, Validator)



## 🔧 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](https://github.com/nanobrowser/nanobrowser/releases).



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, Validator)



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](https://nodejs.org/) (v22.12.0 or higher)

   * [pnpm](https://pnpm.io/installation) (v9.15.1 or higher)



2. **Clone the Repository**:

   ```bash

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

   cd nanobrowser

   ```



3. **Install Dependencies**:

   ```bash

   pnpm install

   ```



4. **Build the Extension**:

   ```bash

   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):

   ```bash

   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 & Validator**: Claude 3.7 Sonnet

  - Better reasoning and planning capabilities

  - More reliable task validation

- **Navigator**: Claude 3.5 Haiku

  - Efficient for web navigation tasks

  - Good balance of performance and cost



### Cost-Effective Configuration

- **Planner & Validator**: Claude Haiku or GPT-4o

  - Reasonable performance at lower cost

  - May require more iterations for complex tasks

- **Navigator**: Gemini 2.0 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**:

  - **Falcon3 10B**

  - **Qwen 2.5 Coder 14B**

  - **Mistral Small 24B**

  - We welcome community experience sharing with other local models in our [Discord](https://discord.gg/NN3ABHggMK)



- **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](https://discord.gg/NN3ABHggMK) 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](https://github.com/nanobrowser/nanobrowser/discussions/85). 



## 🤝 Contributing



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



*  **Share Prompts & Use Cases** 

   * Join our [Discord server](https://discord.gg/NN3ABHggMK).

   * 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](https://discord.gg/NN3ABHggMK).

* **Contribute Code**

   * Check out our [CONTRIBUTING.md](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](https://github.com/nanobrowser/nanobrowser/security/advisories/new) 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](https://discord.gg/NN3ABHggMK) - Chat with team and community

- [Twitter](https://x.com/nanobrowser_ai) - Follow for updates and announcements

- [GitHub Discussions](https://github.com/nanobrowser/nanobrowser/discussions) - Share ideas and ask questions



## 👏 Acknowledgments



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



- [Browser Use](https://github.com/browser-use/browser-use)

- [Puppeteer](https://github.com/EmergenceAI/Agent-E)

- [Chrome Extension Boilerplate](https://github.com/Jonghakseo/chrome-extension-boilerplate-react-vite)

- [LangChain](https://github.com/langchain-ai/langchainjs)



Huge thanks to their creators and contributors!



## 📄 License



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



Made with ❤️ by the Nanobrowser Team. 



Like Nanobrowser? Give us a star 🌟 and join us in [Discord](https://discord.gg/NN3ABHggMK) | [X](https://x.com/nanobrowser_ai)