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

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.2
File Size Uploaded Provenance Actions
notte_sdk-1.10.2.tar.gz 162.9 kB Without provenance Details for notte_sdk-1.10.2.tar.gz

Built distribution (wheel)

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

Total release size: 330.4 kB

Release files / notte_sdk-1.10.2.tar.gz

Download URL notte_sdk-1.10.2.tar.gz
Size 162.9 kB
Tags Source
SHA-256 checksum
How to use checksums
ed9eb1b7a726257c43304b2bf04d13d4650ad079839afea59d8717a96fea6ff3
BLAKE2b-256 checksum
How to use checksums
1686cb2c6c76d182cc4632a444304862b71a300406ba126e63dae165da61500c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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.2-py3-none-any.whl

Download URL notte_sdk-1.10.2-py3-none-any.whl
Size 167.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4b473791c69eea78e87efe57f8c26db3bc76561dd7680e85ef5addcb5e36690a
BLAKE2b-256 checksum
How to use checksums
acd80cf0b8877ef0fe6431bc26394344f543429f923955860e5e1a852c75ef7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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.2

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