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

](https://github.com/nottelabs/notte/stargazers) [ ](https://www.python.org/downloads/) [ [](https://pepy.tech/projects/notte)

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](#using-python-sdk-recommended) → Give AI agents natural language tasks to complete on websites
• [Structured Output](#structured-output) → Get data in your exact format with Pydantic models
• [Site Interactions](#scraping) → Observe website states, scrape data and execute actions using Playwright compatible primitives and natural language commands

API service (Recommended)

• [Stealth Browser Sessions](#session-features) → Browser instances with built-in CAPTCHA solving, proxies, and anti-detection
• [Hybrid Workflows](#workflows) → Combine scripting and AI agents to reduce costs and improve reliability
• [Secrets Vaults](#agent-vault) → Enterprise-grade credential management to store emails, passwords, MFA tokens, SSO, etc.
• [Digital Personas](#agent-persona) → 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
import os

client = NotteClient(api_key=os.getenv("NOTTE_API_KEY"))