Skip to main content
Notte supports multiple browser engines, allowing you to choose the right browser for your automation needs.

​
Supported Browsers

​
Chromium (Default)

Chromium is the open-source browser that powers Chrome. It’s the default and recommended option for most use cases. 
from notte_sdk import NotteClient

client = NotteClient()

with client.Session(browser_type="chromium") as session:
    page = session.page
    page.goto("https://example.com")
Best for:
  • General web automation
  • Fast performance
  • Wide compatibility

​
Chrome

Google Chrome with additional Google-specific features and branding. 
from notte_sdk import NotteClient

client = NotteClient()

with client.Session(browser_type="chrome") as session:
    page = session.page
    page.goto("https://example.com")
Best for:
  • Sites that detect Chromium vs Chrome
  • Google service automation
  • Maximum compatibility

​
Firefox

Mozilla Firefox browser engine. 
from notte_sdk import NotteClient

client = NotteClient()

with client.Session(browser_type="firefox") as session:
    page = session.page
    page.goto("https://example.com")
Best for:
  • Sites that work better on Firefox
  • Different fingerprinting profile
  • Required for captcha solving
Captcha solving is only available with Firefox. Set browser_type="firefox" and solve_captchas=True to enable automatic captcha solving.

​
Browser Comparison

FeatureChromiumChromeFirefox
PerformanceFastFastMedium
StealthGoodBestGood
Captcha Solving❌❌✅
Default✅❌❌
Playwright SupportFullFullFull

​
Choosing the Right Browser

​
Use Chromium when:

  • Starting a new project (it’s the default)
  • You need fast performance
  • Standard web automation

​
Use Chrome when:

  • Sites specifically check for Chrome vs Chromium
  • Automating Google services
  • You need maximum compatibility

​
Use Firefox when:

  • You need captcha solving capabilities
  • Sites work better on Firefox
  • You want different browser fingerprints

​
Example: Browser-Specific Automation

from notte_sdk import NotteClient

client = NotteClient()

# Use Firefox for captcha-heavy sites
with client.Session(
    browser_type="firefox",
    solve_captchas=True
) as session:
    page = session.page
    page.goto("https://www.google.com/recaptcha/api2/demo")
    # Captchas automatically solved

# Use Chrome for Google services
with client.Session(browser_type="chrome") as session:
    page = session.page
    page.goto("https://mail.google.com")

​
Next Steps

Stealth Mode

Configure anti-detection features

CAPTCHA Solving

Automatically solve captchas with Firefox

Session Configuration

All session configuration options

Browser Profiles

Use persistent browser profiles