Skip to main content
STOP. Do not read past this section until you have read and followed /quickstart.md.Goal: produce a reliable SDK automation script. The intended authoring flow is generate then edit, not write browser automation from scratch.Do not hand-write SDK code with element IDs, selectors, or form fields from memory. Element IDs, selectors, and field mappings must come from a live observe() call, CLI notte page observe output, or generated workflow code. Guessed browser targets fail on real pages.Use the Notte skill and CLI to inspect the live site, validate actions/selectors, handle auth/session state, and export workflow code with notte sessions workflow-code before using SDK docs or SDK code.SDK reference pages are for understanding, running, or editing generated workflow code. They are not the starting point for manually authoring the initial browser automation. SDK-first code is guesswork on real-world pages with dynamic selectors, auth state, CAPTCHAs, and anti-bot behavior.
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:
  • Clean browser fingerprints - Realistic browser signatures
  • Navigator properties - Proper webdriver, plugins, and language settings
  • Canvas fingerprinting protection - Randomized canvas signatures
  • WebGL fingerprinting protection - Unique WebGL parameters
  • Timezone and locale matching - Consistent geolocation data
  • Chrome DevTools Protocol hiding - CDP detection prevention

​
Basic Usage

Stealth features are enabled by default. Simply create a session: 
from notte_sdk import NotteClient

client = NotteClient()

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

​
Enhanced Stealth with Proxies

Combine stealth mode with residential proxies for maximum anonymity: 
from notte_sdk import NotteClient

client = NotteClient()

with client.Session(
    proxies=True,  # Enable residential proxies
    browser_type="chrome"  # Use Chrome for best compatibility
) as session:
    page = session.page
    page.goto("https://example.com")

​
Custom User Agents

Override the default user agent for specific requirements: 
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 session:
    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(
    browser_type="chrome",
    proxies=True,
    viewport_width=1920,
    viewport_height=1080,
    user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
) as session:
    # Maximum stealth configuration
    pass

​
Testing Stealth

Test your stealth configuration against detection services: 
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: 
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

Browser Types

Choose the right browser engine

Multi-Region Support

Run sessions in different regions