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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file notte_sdk-1.8.26.tar.gz.
File metadata
- Download URL: notte_sdk-1.8.26.tar.gz
- Upload date:
- Size: 72.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0a23586ccf7c7175b99c758bff0c619291d9487c62005ba722c2007ecd362fe3
|
|
| MD5 |
a73be622bbf436ba65f9135fff0c7424
|
|
| BLAKE2b-256 |
9d9aefb4393b728be9e1d7fe4afb2f27b8562ad0a0860381c6edc3948ff96b2d
|
File details
Details for the file notte_sdk-1.8.26-py3-none-any.whl.
File metadata
- Download URL: notte_sdk-1.8.26-py3-none-any.whl
- Upload date:
- Size: 82.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8a0d91e590e509dfc4e05b25c8304011e07562b1937800ff000c9edb8e931099
|
|
| MD5 |
8b27de25d6eac61746834927180c2f94
|
|
| BLAKE2b-256 |
1e01d786d9f29c1bd765a6d2f124838916e216cf3213e163d53ca6197df2aeb4
|
