NotteClient

The starting point for all operations

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

​

Installation

you can install the notte sdk using pip:

pip install notte-sdk

​

Overview

With the notte sdk, everything starts by creating your NotteClient:

client.py

from notte_sdk import NotteClient

client = NotteClient()

From there, you’re able to create browser sessions, run functions, or manage credential vaults.

​

Migrating from the legacy agent APIs

The hosted agent APIs are deprecated. The SDK’s notte.Agent, client.Agent, client.agents and AgentFallback interfaces were removed in 1.10.

Use browser sessions for scripted browser work, or the CLI and MCP server to give your coding agent a browser. On local Python sessions (notte.Session), use session.act() for individual natural-language browser actions. Deploy reusable automations with Functions.

​

Available Operations

Sessions

List and manage browser sessions

Functions

Create and manage functions for your automations

​

Available Tooling for your agents

File Storage

Upload and download files to and from your agents

Personas

Create and manage personas

Vaults

Create and manage secure credential vaults for your agents

​

Async client

For asyncio code, use AsyncNotteClient, where the methods that call the API are coroutines with the same names and arguments (a few helpers that make no request stay plain methods).