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
2 maintainers
Metadata
2 maintainers
Release files for notte-sdk 1.9.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| notte_sdk-1.9.4.tar.gz | 83.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| notte_sdk-1.9.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 177.8 kB
Release files / notte_sdk-1.9.4.tar.gz
| Download URL | notte_sdk-1.9.4.tar.gz |
|---|---|
| Size | 83.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
74a90627c1579cbe71ebf5cb20a89066ca16bd04d193f91542140a0b47fae511
|
|
BLAKE2b-256 checksum How to use checksums |
b07cad94a0d75b2e2d71533b2ee7c2e1524cbf533d8ac0b93d8a76f8a831aae5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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.4-py3-none-any.whl
| Download URL | notte_sdk-1.9.4-py3-none-any.whl |
|---|---|
| Size | 94.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ed8acfd8dfb052a9feb9a49677765a92da480c98a6148d744a07944d68f9041c
|
|
BLAKE2b-256 checksum How to use checksums |
bef0634777d5323748d4667f541038fd3abf947cab9a20c37f47d0d6b2fcf0ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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}
|
