Skip to main content

Notte SDK

Python SDK for the Notte API: hosted browser sessions with stealth, CAPTCHA solving and proxies, serverless functions, credential vaults and personas.

Installation

pip install notte-sdk
# to drive sessions with Playwright over CDP
pip install 'notte-sdk[playwright]'

If no API key is passed or set in NOTTE_API_KEY, the SDK reads the matching API key saved by notte auth login from the operating system credential store.

Quick start

from notte_sdk import NotteClient

client = NotteClient()  # reads NOTTE_API_KEY

with client.Session(open_viewer=True) as session:
    _ = session.execute(type="goto", url="https://news.ycombinator.com")
    obs = session.observe()
    markdown = session.scrape(only_main_content=True)

What's inside

  • client.Session(...): cloud browser sessions (execute, observe, scrape, cookies, file storage, live view, replays) reachable over CDP with session.cdp_url()
  • client.Function(...) / client.functions: deploy a Python file with a run function and run it on the Notte cloud
  • client.Vault(...): store credentials that sessions fill in without exposing them to your code
  • client.Persona(...): identities with their own email address and phone number
  • client.scrape(url, ...): one-call scraping, with instructions / response_format for structured output

See the documentation for the full reference.

Metadata

Release files for notte-sdk 1.10.0

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.10.0
File Size Uploaded Provenance
notte_sdk-1.10.0.tar.gz 159.4 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for notte-sdk 1.10.0
File Interpreter ABI Platform
notte_sdk-1.10.0-py3-none-any.whl Python 3 none any Details

Total release size: 325.7 kB

Release files / notte_sdk-1.10.0.tar.gz

Download URL notte_sdk-1.10.0.tar.gz
Size 159.4 kB
Tags Source
SHA-256 checksum
How to use checksums
514019d2509ca336f236a6e82ba4440ea3a90d32a0c770434c288340a95de03a
BLAKE2b-256 checksum
How to use checksums
a5ecdaac55463ae14cf7c29ff969e6000a1835cd2c1d20a50de07c4e7ebf9bb7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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.10.0-py3-none-any.whl

Download URL notte_sdk-1.10.0-py3-none-any.whl
Size 166.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9d32d45190f6ec5180d984c9b883ad22d84c50f3b0d166b0dddc2de4867a4a69
BLAKE2b-256 checksum
How to use checksums
c2109118d56262bf030455812b6b53328cb0a3b39af837a95e85fb3375855707
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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}

Security for notte-sdk 1.10.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.10.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page