> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notte.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# NotteClient

> The starting point for all operations

> [!TIP]
>
> Read [the Notte skill](https://notte.cc/skill.md) 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:

```bash theme={null}
pip install notte-sdk
```

### Overview

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

```python client.py theme={null}
from notte_sdk import NotteClient

client = NotteClient()
```

```typescript client.ts theme={null}
import { NotteClient } from 'notte-sdk';

const client = new 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](https://docs.notte.cc/concepts/sessions.md) for scripted browser work, or the [CLI](https://docs.notte.cc/cli-reference/index.md) and [MCP server](https://docs.notte.cc/mcp-server.md) to give your coding agent a browser. On local Python sessions (`notte.Session`), use [session.act()](https://docs.notte.cc/features/sessions/act.md) for individual natural-language browser actions. Deploy reusable automations with [Functions](https://docs.notte.cc/concepts/functions.md).

## Available Operations

> [card] [Sessions](https://docs.notte.cc/sdk-reference/manual/session.md)
>
> List and manage browser sessions

> [card] [Functions](https://docs.notte.cc/sdk-reference/manual/function.md)
>
> Create and manage functions for your automations

## Available Tooling for your agents

> [card] [File Storage](https://docs.notte.cc/sdk-reference/manual/file_storage.md)
>
> Upload and download files to and from your agents

> [card] [Personas](https://docs.notte.cc/sdk-reference/manual/persona.md)
>
> Create and manage personas

> [card] [Vaults](https://docs.notte.cc/sdk-reference/manual/vault.md)
>
> Create and manage secure credential vaults for your agents

## Async client

For asyncio code, use [`AsyncNotteClient`](https://docs.notte.cc/sdk-reference/manual/async.md), 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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.