# Nanobrowser documentation

What Nanobrowser is, what it can and can't do, how it works, and where to start.

- [Quickstart](https://nanobrowser.ai/docs/quickstart): Install the extension, connect a model and run your first task.
- [Choosing a model](https://nanobrowser.ai/docs/models): Pick a cloud or local model that works well with the agent.
- [Ask and Auto mode](https://nanobrowser.ai/docs/permissions): Decide when the agent asks you before it acts.
- [Privacy and security](https://nanobrowser.ai/docs/privacy): See what leaves your browser, where it goes and how to stay safe.

Nanobrowser is a free, open-source AI agent that works in your own browser. Tell it a task in the side panel. It reads the pages, clicks, types and moves between tabs to get it done. In Ask mode, the default, it asks you before it submits, sends, deletes or uploads anything.

It runs in Chrome and Edge. You bring the model: a cloud provider with your own API key, or a model on your own computer. Nanobrowser itself costs nothing.

## What is it good at?

- **Reading and summing up.** Summarize a page, or pull the main points out of a long article.
- **Research across sites.** Search several sites and put what it finds in a table.
- **Forms and routine steps.** Fill in a form with the details you give it.
- **Saving results.** Save a table as a CSV file or a report as Markdown to your Downloads folder.
- **Working while you browse.** Each task runs in its own tab group, so you can run a few at once.

It works in your real browser, where you're already signed in. It doesn't need a separate account or a copy of your passwords.

## What can't it do?

- **It isn't perfect.** It can misread a page or take a wrong step. Watch it, and click **Stop** to take over.
- **It doesn't pay or sign in for you.** When it reaches a payment, a password, a code or a "Sign in with…" permission screen, it hands that step to you. It may not spot every one.
- **It can't use every page.** Browser pages such as `chrome://` pages, the extension stores, files on your computer and the PDF viewer are off limits. See [Pages the agent can't use](https://nanobrowser.ai/docs/troubleshooting#pages-it-cant-use).
- **It works only while your browser is open.** It doesn't run tasks on a schedule or on a server.
- **It needs a model that supports tool calling.** Not every model can run the agent. See [Choosing a model](https://nanobrowser.ai/docs/models).

## How does it work?

1. You type a task in the side panel.
2. Nanobrowser sends your task, and what it sees on the page, to the model you picked.
3. The model chooses the next step, such as a click, some typing or a new tab.
4. Nanobrowser does that step in your browser and tells the model what happened.
5. This repeats until the task is done. Then the agent answers you in the chat.

Your settings decide which steps need your OK. The model can't change them. See [Ask and Auto mode](https://nanobrowser.ai/docs/permissions).

The page content goes to the model provider you choose. No Nanobrowser server sees it. See [Privacy and security](https://nanobrowser.ai/docs/privacy).

## Next steps

- [Install Nanobrowser and run a first task](https://nanobrowser.ai/docs/quickstart)
- [Choose a model](https://nanobrowser.ai/docs/models), or [run a local model](https://nanobrowser.ai/docs/local-models)
- [Learn the side panel](https://nanobrowser.ai/docs/side-panel)
- [Build it from source](https://nanobrowser.ai/docs/developers)
