Stealth Mode

Configure anti-detection features for your browser sessions

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

Notte sessions include built-in stealth features to help your automations avoid detection by anti-bot systems.

Built-in Stealth Features

All Notte sessions automatically include:

• Coherent browser fingerprint - A realistic, recent Chrome desktop fingerprint (user agent, platform, screen, and graphics hardware) that stays internally consistent
• Location matching - Timezone, locale, and geolocation follow the session’s proxy exit IP
• Residential proxies - On by default (proxies=True). See Proxies
• Captcha solving - On by default (solve_captchas=True). See CAPTCHA Solving

Basic Usage

Stealth features are enabled by default. Simply create a session:

Python

from notte_sdk import NotteClient

client = NotteClient()

with client.Session() as session:
    page = session.page
    page.goto("https://example.com")
    # Stealth features automatically active

Proxy Location

Residential proxies are on by default and exit in the US. Pick a country to match your target site; the fingerprint’s timezone and locale follow it:

Python

from notte_sdk import NotteClient

client = NotteClient()

with client.Session(proxies="fr") as session:
    page = session.page
    page.goto("https://example.com")

Advanced Stealth

For sites with sophisticated bot detection, advanced_stealth=True runs the session in Notte’s highest-fidelity browser environment. It is available to approved workspaces; contact [e-mail] to enable it.

Python

from notte_sdk import NotteClient

client = NotteClient()

with client.Session(advanced_stealth=True) as session:
    page = session.page
    page.goto("https://example.com")

Custom User Agents

Override the default user agent for specific requirements. Note that a custom user agent replaces the one Notte generates to match the rest of the fingerprint:

Python

from notte_sdk import NotteClient

client = NotteClient()

with client.Session(
    user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
) as session:
    page = session.page
    page.goto("https://example.com")

Stealth Best Practices

1. Use Realistic Behavior

Avoid patterns that look automated:

realistic_behavior.py

import random
import time

from notte_sdk import NotteClient

client = NotteClient()

with client.Session() as session:
    page = session.page
    page.goto("https://example.com")

    # Bad: Instant actions
    page.click("button")
    page.fill("input", "text")

    # Good: Human-like delays
    page.click("button")
    time.sleep(random.uniform(0.5, 1.5))
    page.fill("input", "text")

2. Rotate Proxies

Use different proxies for different sessions:

rotate_proxies.py

from notte_sdk import NotteClient

client = NotteClient()

# Session 1 with US proxy
with client.Session(proxies="us") as session:
    # automation
    pass

# Session 2 with UK proxy
with client.Session(proxies="gb") as session:
    # automation
    pass

3. Match Viewport to Real Devices

Use common screen resolutions:

match_viewport.py

from notte_sdk import NotteClient

client = NotteClient()

# Desktop
with client.Session(viewport_width=1920, viewport_height=1080) as desktop:
    pass

# Laptop
with client.Session(viewport_width=1366, viewport_height=768) as session:
    pass

4. Combine Multiple Techniques

Layer stealth features for best results:

combine_techniques.py

from notte_sdk import NotteClient

client = NotteClient()

with client.Session(
    proxies=True,
    viewport_width=1920,
    viewport_height=1080,
) as session:
    # Maximum stealth configuration
    pass

Testing Stealth

Test your stealth configuration against detection services:

Python

from notte_sdk import NotteClient

client = NotteClient()

test_sites = [
    "https://bot.sannysoft.com/",
    "https://arh.antoinevastel.com/bots/areyouheadless",
    "https://fingerprint.com/demo/"
]

with client.Session(proxies=True) as session:
    page = session.page

    for site in test_sites:
        page.goto(site)
        page.screenshot(path=f"stealth_test_{site.split('//')[1].split('/')[0]}.png")

What Stealth Can’t Do

Stealth features help avoid detection, but they cannot:

• ❌ Bypass login rate limits (use delays between attempts)
• ❌ Avoid behavioral analysis (act like a human)
• ❌ Bypass IP-based blocking (use proxy rotation)
• ❌ Solve all captchas automatically (use captcha solving)

Stealth + Captcha Solving

Combine stealth with automatic captcha solving for comprehensive protection:

Python

from notte_sdk import NotteClient

client = NotteClient()

with client.Session(
    solve_captchas=True,
    proxies=True
) as session:
    page = session.page
    page.goto("https://example.com/login")
    # Both stealth and captcha solving active

Next Steps

Proxies

Configure residential proxies

CAPTCHA Solving

Automatically solve captchas

Session Configuration

All session configuration options

Browser Profiles

Reuse logged-in browser state