Notte SDK

The Notte SDK is a powerful Python library that provides a seamless interface for interacting with web automation and AI-powered agents. It enables developers to create, manage, and monitor web automation sessions and AI agents with ease.

Key Features

Session Management: Create, monitor, and control web automation sessions
Agent Orchestration: Deploy and manage AI agents for automated web tasks
CDP Integration: Direct Chrome DevTools Protocol integration for advanced browser control
Web Automation: Built-in tools for web page observation, scraping, and action execution
Real-time Monitoring: Live session viewing and debugging capabilities

Installation

pip install notte-sdk

Quick Start

import os
from notte_sdk import NotteClient

# Initialize the client
notte = NotteClient(api_key=os.getenv("NOTTE_API_KEY"))

# Run an AI agent
with notte.Session(open_viewer=True) as session:
    agent = notte.Agent(session=session)
    agent.run(
        task="What is the capital of France?",
        url="https://www.google.com",
    )

Core Components

Session Management

The SDK provides comprehensive session management capabilities:

from notte_sdk import NotteClient
notte = NotteClient()

# Start a new session
with notte.Session(timeout_minutes=5) as session:
    # Get session status
    status = session.status()
    # View live session
    session.viewer()

Agent Operations

Deploy and manage AI agents for automated tasks:

from notte_sdk import NotteClient
notte = NotteClient()
# Run an agent with specific tasks

with notte.Session(open_viewer=True) as session:
    agent = notte.Agent(session=session)
    # Start an agent with non-blocking call
    agent.start(
        task="Summarize the content of the page",
        url="https://www.google.com"
    )

# Monitor agent status
status = agent.status()
# List active agents
agents = notte.agents.list()

# Stop an agent
agent.stop()

Web Automation

Execute web automation tasks with built-in tools:

from notte_sdk import NotteClient
notte = NotteClient()

with notte.Session(open_viewer=True) as session:
    # Observe a web page
    _ = session.execute(type="goto", url="https://www.google.com")
    obs = session.observe()
    # Execute actions
    action = obs.space.sample(type='click')
    result = session.execute(action)
    assert result.success
    # Scrape content
    markdown = session.scrape()
    print(markdown)

CDP Integration

Integrate with Chrome DevTools Protocol for advanced browser control:

from patchright.sync_api import sync_playwright
from notte_sdk import NotteClient
notte = NotteClient()

with notte.Session(proxies=False) as session:
    cdp_url = session.cdp_url()
    with sync_playwright() as p:
        browser = p.chromium.connect_over_cdp(cdp_url)
        page = browser.contexts[0].pages[0]
        page.goto("https://www.google.com")

Advanced Features

Real-time session monitoring and debugging
Automated web scraping and content analysis
AI-powered task automation
Flexible session configuration
Comprehensive error handling and logging

Support

For support, please contact us at hello@notte.cc

Metadata

Release files for notte-sdk 1.9.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for notte-sdk 1.9.6
File	Size	Uploaded
notte_sdk-1.9.6.tar.gz	86.9 kB	Oct 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for notte-sdk 1.9.6
File	Interpreter	ABI	Platform	Reset
notte_sdk-1.9.6-py3-none-any.whl 98.0 kB Oct 7, 2026	Python 3	none	any	Details

Total release size: 184.9 kB

Release files / notte_sdk-1.9.6.tar.gz

Download URL	notte_sdk-1.9.6.tar.gz
Size	86.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`98cfdc0bc641156191d73fac99e53ead473d767cf281b9a95237d4ac51ef0f8b`
BLAKE2b-256 checksum How to use checksums	`a0008469004c461dd91a2b4989834b502d9a010472e58438909d3e55285fe890`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / notte_sdk-1.9.6-py3-none-any.whl

Download URL	notte_sdk-1.9.6-py3-none-any.whl
Size	98.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fbf772dc81a686a31d26013c09f9fe63ec91e3f24293794eff3d20185f1bdf60`
BLAKE2b-256 checksum How to use checksums	`9fd03c710185bbabd080b3f6136e7b90e6566db62b0f50670bd3f8f4122e95a5`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`