Notte is a Python-based framework to build and deploy AI-driven web automation agents with a mix of open-source features and hosted API options. It includes structured outputs, vaults, personas, stealth sessions, and CDP browser support; latest releases show small change sets. License is SSPL-1.0 in README, but FACTS list license as none.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Notte provides tools for building and deploying AI agents that interact with the web. It supports running agents locally with a Python SDK and offers an API service for browser sessions, including features like stealth sessions, vaults for credentials, and digital personas.
How it works
The project combines AI agents with scripting to perform web automation. It includes a Python SDK, an API client, and a session model that can open browser sessions, run agents with a reasoning model, and mix scripted steps with agent-based reasoning. It also offers a structured output mechanism using Pydantic models and a vault for credentials. It mentions CDP browser compatibility to plug in external browser providers.
Getting started
pip install notte
patchright install --with-deps chromium
Run in local mode
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)
from notte_sdk import NotteClient
import os
client = NotteClient(api_key=os.getenv("NOTTE_API_KEY"))
with client.Session(open_viewer=True) as session:
agent = client.Agent(session=session, reasoning_model='gemini/gemini-2.5-flash', max_steps=30)
response = agent.run(task="doom scroll cat memes on google images")
Recent releases
- v1.8.28 (2026-07-13): docs: regenerate llms.txt with GET /ready endpoint
- v1.8.26 (2026-07-09): docs: regenerate llms.txt with GET /ready endpoint
- v1.8.25 (2026-07-06): docs: regenerate llms.txt with GET /ready endpoint
- v1.8.24 (2026-06-23): docs(mcp): document hosted MCP server at api.notte.cc/mcp
- v1.8.23 (2026-06-16): Fix scrape schema RootModel handling
Traction
Not provided in the README. Star counts in FACTS: 1987 stars.
Behind the repo
Not applicable: no linked startup/company section in provided content.
Caveats
License: Server Side Public License v1 as stated in README; other sections list license as SSPL-1.0 in badges. Created: 2024-12-08. Last push: 2026-08-04. Language: Python.