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

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.4
File Size Uploaded Provenance Actions
notte_sdk-1.10.4.tar.gz 164.8 kB Without provenance Details for notte_sdk-1.10.4.tar.gz

Built distribution (wheel)

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

Total release size: 334.2 kB

Release files / notte_sdk-1.10.4.tar.gz

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

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

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