Configuration

All Nanobrowser settings can be managed through the Options page. You can access it by clicking the Settings icon (⚙️) in the side panel header.

LLM Providers

Nanobrowser requires you to connect your own Large Language Model (LLM) provider accounts. Your API keys are stored securely and locally in your browser's storage and are never transmitted to any third-party servers other than the LLM provider you've configured.

Supported Providers

Nanobrowser supports a variety of providers out-of-the-box, including:

  • OpenAI
  • Anthropic
  • Google Gemini
  • Groq
  • Ollama (for local models)
  • Azure OpenAI
  • Any other OpenAI-compatible API

Adding a New Provider

  1. Navigate to the Settings page and select the Models tab.
  2. Click the + Add New Provider button.
  3. Select your desired provider from the dropdown list.
  4. Fill in the required details, such as the API Key and, if necessary, the Base URL.
  5. Click Save.

Analytics (Optional)

By default, Nanobrowser collects completely anonymous usage data to help us improve the extension. We are committed to your privacy, and you can disable this feature at any time.

What We Collect

  • Anonymous task metrics (e.g., execution times, error categories)
  • Domain names visited (e.g., google.com, never full URLs)
  • A randomly generated anonymous user identifier

What We Never Collect

  • Personal information, credentials, or API keys
  • Full URLs, page content, screenshots, or task instructions
  • Any personally identifiable information (PII)

How to Disable Analytics

  1. Go to the Settings page.
  2. Navigate to the Analytics tab.
  3. Toggle off the "Help improve Nanobrowser" switch.

Configuration for Developers

If you are building from source, you can configure your own PostHog analytics endpoint. Create a .env file in the root of the project with the following content:

# PostHog Analytics Configuration
# Get your API key from: https://app.posthog.com/project/settings
VITE_POSTHOG_API_KEY=your-posthog-api-key-here

# Optional: Custom PostHog host (defaults to https://app.posthog.com)
# VITE_POSTHOG_HOST=https://your-custom-posthog-host.com