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",
    )

When api_key and NOTTE_API_KEY are both unset, the client falls back to the API key saved by notte auth login for the API environment in use.

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

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.7
File	Size	Uploaded
notte_sdk-1.9.7.tar.gz	93.0 kB	Oct 14, 2026	Details

Built distribution (wheel)

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

Total release size: 197.5 kB

Release files / notte_sdk-1.9.7.tar.gz

Download URL	notte_sdk-1.9.7.tar.gz
Size	93.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`8d1cf5fd68c4483da89a7c3413442d8cf1ef0779c4cbe85127ee2b8708ab5ccf`
BLAKE2b-256 checksum How to use checksums	`519d5ad7f8fa8af5c6b02ee9075cca6e7cc554a01138ada6e98fd2dff06dc277`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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.7-py3-none-any.whl

Download URL	notte_sdk-1.9.7-py3-none-any.whl
Size	104.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`567f234231edafcb4c61b9fa666f2b445e6046bf4d16d55e6de977a9fe60372d`
BLAKE2b-256 checksum How to use checksums	`f6f8b3ffebe5069ab2f73100429a6ceb7e1fc21b41b46f699bf8ef91f98221c0`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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}`