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

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.5
File	Size	Uploaded
notte_sdk-1.9.5.tar.gz	86.5 kB	Oct 6, 2026	Details

Built distribution (wheel)

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

Total release size: 184.0 kB

Release files / notte_sdk-1.9.5.tar.gz

Download URL	notte_sdk-1.9.5.tar.gz
Size	86.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`9af5fb7a22ecfc65059b9a1d947da2b3088548e0cc057020c57d4856a2cd25c9`
BLAKE2b-256 checksum How to use checksums	`b01868c5cc49909fa58edd7abe8313a66efd476ddeca990ec0e5e9af6c1f6068`
Upload date	Oct 6, 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.5-py3-none-any.whl

Download URL	notte_sdk-1.9.5-py3-none-any.whl
Size	97.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`48f5ded5f1fba72ee6796de524ad5157b10d50416330d2c70b04dc1dd052a319`
BLAKE2b-256 checksum How to use checksums	`29a4ae3c29edd6a2b531b11fe9acc96923daf9e42f6afe990a6a647e7f00dbb9`
Upload date	Oct 6, 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}`