Notte
Notte is a full-stack framework for building and deploying AI agents that interact with the web. It combines AI agents with traditional scripting to cut costs and improve reliability, offering both open-source and hosted API options. It is for developers who need to automate web tasks, scrape data, or build complex web automation workflows.
✨ Key features
- Run natural language web agents with Python SDK or open-source core.
- Structured output with Pydantic models for exact data formats.
- Stealth browser sessions with CAPTCHA solving and proxies.
- Hybrid workflows mixing scripting and AI agents for cost efficiency.
- Agent vault for secure credential management and persona for digital identities.
- File upload/download, cookies/auth sessions, and CDP browser compatibility.
🎯 Use cases
- Automate form filling, login, and data extraction on websites.
- Scrape structured data from web pages with custom instructions.
- Create accounts or perform actions requiring 2FA using digital personas.
- Build hybrid workflows that script deterministic steps and use AI for reasoning.
- Monitor or interact with web applications using natural language commands.
📦 Installation
🧰 Requirements: Python 3.x, install with pip, requires LLM API keys for local mode or Notte API key for hosted sessions.
pip install notte
patchright install --with-deps chromium
🚀 Usage
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")
⚠️ Good to know
The open-source core requires your own LLM API keys, while the hosted API is recommended for premium features like stealth and vaults.
❓ FAQ
What is the difference between the open-source core and the API service?
The open-source core provides basic agent and scraping features, while the API service adds stealth browsers, hybrid workflows, vaults, personas, and more.
How do I switch from local to hosted mode?
Replace notte imports with notte_sdk and prefix objects with client to use hosted sessions.
Can I use my own browser with Notte?
Yes, you can connect any CDP-compatible browser via a CDP URL.
Does Notte support structured data extraction?
Yes, you can specify a Pydantic model as response_format to get structured output.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.