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.1

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.1
File	Size	Uploaded
notte_sdk-1.9.1.tar.gz	82.3 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for notte-sdk 1.9.1
File	Interpreter	ABI	Platform	Reset
notte_sdk-1.9.1-py3-none-any.whl 92.7 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 175.0 kB

Release files / notte_sdk-1.9.1.tar.gz

Download URL	notte_sdk-1.9.1.tar.gz
Size	82.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`21ced8bebb63f76675e030fc472aaf69a7eae69ed560a9abf1e079a8278d2654`
BLAKE2b-256 checksum How to use checksums	`23f81b92060e7b43ca47a12f1cbf5d4571bb0ac7e448c06a544efcc8d6b8cd58`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","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.1-py3-none-any.whl

Download URL	notte_sdk-1.9.1-py3-none-any.whl
Size	92.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`57a664b0498fdd8a95db36d92f0ef7874f08b74a800cf1bcf3fe867b656db288`
BLAKE2b-256 checksum How to use checksums	`72d1eda6a2039d077eb25c847a0f43b2ebfa3b1a879e354748bc37aaa94a4dd9`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","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}`