Rapidly build reliable web automation agents
The web agent framework built for speed, cost-efficiency, scale, and reliability
→ Read more at: open-operator-evals • X • LinkedIn • Landing • Console
What is Notte?
Notte provides all the essential tools for building and deploying AI agents that interact seamlessly with the web. Our full-stack framework combines AI agents with traditional scripting for maximum efficiency - letting you script deterministic parts and use AI only when needed, cutting costs by 50%+ while improving reliability. We allow you to develop, deploy, and scale your own agents and web automations, all with a single API. Read more in our documentation here 🔥
Opensource Core:
Run web agents → Give AI agents natural language tasks to complete on websites
→ Give AI agents natural language tasks to complete on websites Structured Output → Get data in your exact format with Pydantic models
→ Get data in your exact format with Pydantic models Site Interactions → Observe website states, scrape data and execute actions using Playwright compatible primitives and natural language commands
API service (Recommended)
Stealth Browser Sessions → Browser instances with built-in CAPTCHA solving, proxies, and anti-detection
→ Browser instances with built-in CAPTCHA solving, proxies, and anti-detection Hybrid Workflows → Combine scripting and AI agents to reduce costs and improve reliability
→ Combine scripting and AI agents to reduce costs and improve reliability Secrets Vaults → Enterprise-grade credential management to store emails, passwords, MFA tokens, SSO, etc.
→ Enterprise-grade credential management to store emails, passwords, MFA tokens, SSO, etc. Digital Personas → Create digital identities with unique emails, phones, and automated 2FA for account creation workflows
Quickstart
pip install notte patchright install --with-deps chromium
Run in local mode
Use the following script to spinup an agent using opensource features (you'll need your own LLM API keys):
import notte from dotenv import load_dotenv load_dotenv () with notte . Session ( headless = False ) as session : agent = notte . Agent ( session = session , reasoning_model = 'gemini/gemini-2.5-flash' , max_steps = 30 ) response = agent . run ( task = "doom scroll cat memes on google images" )
Using Python SDK (Recommended)
We also provide an effortless API that hosts the browser sessions for you - and provide plenty of premium features. To run the agent you'll need to first sign up on the Notte Console and create a free Notte API key 🔑
from notte_sdk import NotteClient cli = NotteClient ( api_key = "your-api-key" ) with cli . Session ( headless = False ) as session : agent = cli . Agent ( session = session , reasoning_model = 'gemini/gemini-2.5-flash' , max_steps = 30 ) response = agent . run ( task = "doom scroll cat memes on google images" )
Our setup allows you to experiment locally, then drop-in replace the import and prefix notte objects with cli to switch to SDK and get hosted browser sessions plus access to premium features!
Benchmarks
Rank Provider Agent Self-Report LLM Evaluation Time per Task Task Reliability 🏆 Notte 86.2% 79.0% 47s 96.6% 2️⃣ Browser-Use 77.3% 60.2% 113s 83.3% 3️⃣ Convergence 38.4% 31.4% 83s 50%
Read the full story here: https://github.com/nottelabs/open-operator-evals
Agent features
Structured output
Structured output is a feature of the agent's run function that allows you to specify a Pydantic model as the response_format parameter. The agent will return data in the specified structure.
from notte_sdk import NotteClient from pydantic import BaseModel from typing import List class HackerNewsPost ( BaseModel ): title : str url : str points : int author : str comments_count : int class TopPosts ( BaseModel ): posts : List [ HackerNewsPost ] cli = NotteClient () with cli . Session ( headless = False , browser_type = "firefox" ) as session : agent = cli . Agent ( session = session , reasoning_model = 'gemini/gemini-2.5-flash' , max_steps = 15 ) response = agent . run ( task = "Go to Hacker News (news.ycombinator.com) and extract the top 5 posts with their titles, URLs, points, authors, and comment counts." , response_format = TopPosts , ) print ( response . answer )
Agent vault
Vaults are tools you can attach to your Agent instance to securely store and manage credentials. The agent automatically uses these credentials when needed.
from notte_sdk import NotteClient cli = NotteClient () with cli . Vault () as vault , cli . Session ( headless = False ) as session : vault . add_credentials ( url = "https://x.com" , username = "your-email" , password = "your-password" , ) agent = cli . Agent ( session = session , vault = vault , max_steps = 10 ) response = agent . run ( task = "go to twitter; login and go to my messages" , ) print ( response . answer )
Agent persona
Personas are tools you can attach to your Agent instance to provide digital identities with unique email addresses, phone numbers, and automated 2FA handling.
from notte_sdk import NotteClient cli = NotteClient () with cli . Persona ( create_phone_number = False ) as persona : with cli . Session ( browser_type = "firefox" , headless = False ) as session : agent = cli . Agent ( session = session , persona = persona , max_steps = 15 ) response = agent . run ( task = "Open the Google form and RSVP yes with your name" , url = "https://forms.google.com/your-form-url" , ) print ( response . answer )
Session features
Stealth
Stealth features include automatic CAPTCHA solving and proxy configuration to enhance automation reliability and anonymity.
from notte_sdk import NotteClient from notte_sdk . types import NotteProxy , ExternalProxy cli = NotteClient () # Built-in proxies with CAPTCHA solving with cli . Session ( solve_captchas = True , proxies = True , # US-based proxy browser_type = "firefox" , headless = False ) as session : agent = cli . Agent ( session = session , max_steps = 5 ) response = agent . run ( task = "Try to solve the CAPTCHA using internal tools" , url = "https://www.google.com/recaptcha/api2/demo" ) # Custom proxy configuration proxy_settings = ExternalProxy ( server = "http://your-proxy-server:port" , username = "your-username" , password = "your-password" , ) with cli . Session ( proxies = [ proxy_settings ]) as session : agent = cli . Agent ( session = session , max_steps = 5 ) response = agent . run ( task = "Navigate to a website" )
File download / upload
File Storage allows you to upload files to a session and download files that agents retrieve during their work. Files are session-scoped and persist beyond the session lifecycle.
from notte_sdk import NotteClient cli = NotteClient () storage = cli . FileStorage () # Upload files before agent execution storage . upload ( "/path/to/document.pdf" ) # Create session with storage attached with cli . Session ( storage = storage ) as session : agent = cli . Agent ( session = session , max_steps = 5 ) response = agent . run ( task = "Upload the PDF document to the website and download the cat picture" , url = "https://example.com/upload" ) # Download files that the agent downloaded downloaded_files = storage . list ( type = "downloads" ) for file_name in downloaded_files : storage . download ( file_name = file_name , local_dir = "./results" )
Cookies / Auth Sessions
Cookies provide a flexible way to authenticate your sessions. While we recommend using the secure vault for credential management, cookies offer an alternative approach for certain use cases.
from notte_sdk import NotteClient from notte_sdk . types import Cookie cli = NotteClient () # Upload cookies for authentication cookies = [ Cookie ( name = "sb-db-auth-token" , value = "base64-cookie-value" , domain = "github.com" , path = "/" , expires = 9778363203.913704 , httpOnly = False , secure = False , sameSite = "Lax" ) ] with cli . Session () as session : session . set_cookies ( cookies = cookies ) # or cookie_file="path/to/cookies.json" agent = cli . Agent ( session = session , max_steps = 5 ) response = agent . run ( task = "go to nottelabs/notte get repo info" , ) # Get cookies from the session cookies_resp = session . get_cookies ()
CDP Browser compatibility
You can plug in any browser session provider you want and use our agent on top. Use external headless browser providers via CDP to benefit from Notte's agentic capabilities with any CDP-compatible browser.
from notte_sdk import NotteClient cli = NotteClient () cdp_url = "wss://your-external-cdp-url" with cli . Session ( cdp_url = cdp_url ) as session : agent = cli . Agent ( session = session ) response = agent . run ( task = "extract pricing plans from https://www.notte.cc/" )
Workflows
Notte's close compatibility with Playwright allows you to mix web automation primitives with agents for specific parts that require reasoning and adaptability. This hybrid approach cuts LLM costs and is much faster by using scripting for deterministic parts and agents only when needed.
from notte_sdk import NotteClient import time cli = NotteClient () with cli . Session ( headless = False , perception_type = "fast" ) as page : # Script execution for deterministic navigation page . execute ( type = "goto" , value = "https://www.quince.com/women/organic-stretch-cotton-chino-short" ) page . observe () # Agent for reasoning-based selection agent = cli . Agent ( session = page ) agent . run ( task = "just select the ivory color in size 6 option" ) # Script execution for deterministic actions page . execute ( type = "click" , selector = "internal:role=button[name= \" ADD TO CART \" i]" ) page . observe () page . execute ( type = "click" , selector = "internal:role=button[name= \" CHECKOUT \" i]" ) page . observe () time . sleep ( 5 )
Scraping
For fast data extraction, we provide a dedicated scraping endpoint that automatically creates and manages sessions. You can pass custom instructions for structured outputs and enable stealth mode.
from notte_sdk import NotteClient from pydantic import BaseModel cli = NotteClient () # Simple scraping response = cli . scrape ( url = "https://notte.cc" , scrape_links = True , only_main_content = True ) # Structured scraping with custom instructions class Article ( BaseModel ): title : str content : str date : str response = cli . scrape ( url = "https://example.com/blog" , response_format = Article , instructions = "Extract only the title, date and content of the articles" )
Or directly with cURL
curl -X POST ' https://api.notte.cc/scrape ' \ -H ' Authorization: Bearer ' \ -H ' Content-Type: application/json ' \ -d ' { "url": "https://notte.cc", "only_main_content": false, } '
Search: We've built a cool demo of an LLM leveraging the scraping endpoint in an MCP server to make real-time search in an LLM chatbot - works like a charm! Available here: https://search.notte.cc/
License
This project is licensed under the Server Side Public License v1. See the LICENSE file for details.
Citation
If you use notte in your research or project, please cite:
@software { notte2025 , author = { Pinto, Andrea and Giordano, Lucas and {nottelabs-team} } , title = { Notte: Software suite for internet-native agentic systems } , url = { https://github.com/nottelabs/notte } , year = { 2025 } , publisher = { GitHub } , license = { SSPL-1.0 } version = { 1.4.4 } , }
Copyright © 2025 Notte Labs, Inc.