> ## Documentation Index
> Fetch the complete documentation index at: https://notte-experiment-visibility-md-links.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Notte - The best place to automate the browser

You're at the best place to automate your browser. Notte is a unified platform to build, run, and deploy AI agents and web automation scripts. Browser infrastructure, agents framework, serverless functions, and observability, all in one single place.

## Overview

The **Platform** API services provides the infrastructure and the primitives to run your automations — browser sessions, web agents framework, serverless functions, and scraping APIs. This documentation covers the technical reference for the Platform.

The **Products** help you build faster. Create automation scripts with our AI assistant, teach by workflow demonstration (screen recording), orcode in our automation studio. See the product guides below or jump straight into the [Console](https://console.notte.cc) to get started.

## Getting Started

Start here if you want to go from zero to a working Notte integration as quickly as possible.

### Browser Session Quickstart

The shortest path to a working Notte integration is to create a cloud browser session and connect to it over CDP. If this works, your API key, SDK install, and browser connection are all set up correctly.

<Steps>
  <Step title="Get an API key">
    Create an account on the [Console](https://console.notte.cc) to get your API key.
  </Step>

  <Step title="Export your API key">
    <CodeGroup>
      ```bash Python / Node.js theme={null}
      export NOTTE_API_KEY=your_api_key_here
      ```

      ```python Python theme={null}
      from notte_sdk import NotteClient

      client = NotteClient()  # reads NOTTE_API_KEY automatically
      ```

      ```javascript JavaScript theme={null}
      import { NotteClient } from 'notte-sdk';

      const client = new NotteClient({
        apiKey: process.env.NOTTE_API_KEY,
      });
      ```
    </CodeGroup>
  </Step>

  <Step title="Install the SDK">
    <CodeGroup>
      ```bash Python (requires >= 3.11) theme={null}
      pip install notte-sdk playwright
      ```

      ```bash JavaScript (Node.js 18+) theme={null}
      npm install notte-sdk playwright-core
      ```
    </CodeGroup>
  </Step>
</Steps>

<CodeGroup>
  ```python Python theme={null}
  from playwright.sync_api import sync_playwright
  from notte_sdk import NotteClient

  client = NotteClient()

  with client.Session(open_viewer=True) as session:
      cdp_url = session.cdp_url()

      with sync_playwright() as p:
          browser = p.chromium.connect_over_cdp(cdp_url)
          page = browser.contexts[0].pages[0]
          page.goto("https://www.google.com")
          page.screenshot(path="screenshot.png")
  ```

  ```javascript JavaScript theme={null}
  import { chromium } from 'playwright-core';
  import { NotteClient } from 'notte-sdk';

  const notte = new NotteClient({
    apiKey: process.env.NOTTE_API_KEY,
  });

  await notte.Session({ open_viewer: true }).use(async (session) => {
    const status = await session.status();
    const cdpUrl = status.cdp_url;

    if (!cdpUrl) {
      throw new Error('Session did not return a cdp_url');
    }

    const browser = await chromium.connectOverCDP(cdpUrl);

    try {
      const page = browser.contexts()[0].pages()[0];
      await page.goto('https://news.ycombinator.com');

      const topStories = await page.locator('.titleline > a').allInnerTexts();

      console.log('Top 5 Hacker News stories:');
      topStories.slice(0, 5).forEach((title, index) => {
        console.log(`${index + 1}. ${title}`);
      });
    } finally {
      await browser.close();
    }
  });
  ```
</CodeGroup>

<CardGroup cols={3}>
  <Card title="Quickstart" icon="square-arrow-up-right" href="/quickstart.md">
    Continue to the full quickstart for Agents, Scraping, and additional examples.
  </Card>

  <Card title="SDK Reference" icon="book" href="/sdk-reference/manual/index.md">
    Start from the SDK entrypoint for Sessions, Agents, Vaults, Personas, and Functions.
  </Card>

  <Card title="OpenAPI Spec" icon="code" href="https://api.notte.cc/openapi.json">
    Access the machine-readable API contract directly from the Notte API.
  </Card>
</CardGroup>

For the API surface, see [API Reference](/api-reference/authentication.md); for the SDK entrypoint, see [SDK Reference](/sdk-reference/manual/index.md).

## Platform

The building blocks for your web agents and automations.

<CardGroup cols={2}>
  <Card title="Sessions" icon="tv" href="/concepts/sessions.md">
    Remote browser infrastructure. Fast, scalable browsers with anti-detection, proxies, and captcha solving.
  </Card>

  <Card title="Web Agents" icon="microchip-ai" href="/concepts/agents.md">
    AI web agents & automation framework. Build agents that browse, understand, and complete tasks autonomously.
  </Card>

  <Card title="Functions" icon="flower" href="/concepts/functions.md">
    Deploy your scripts as API endpoints. Serverless automations and agents you can invoke and schedule anywhere.
  </Card>

  <Card title="Scraping" icon="database" href="/concepts/scraping.md">
    Extract structured data with AI. Turn any website into structured data. Use agents or direct scrape endpoints.
  </Card>
</CardGroup>

## Products

Tools to speed up the build, debug, and deploy automations lifecycle.

<CardGroup cols={3}>
  <Card title="Agent Builder" icon="sparkles" href="/product/agent-mode.md">
    Create automation scripts with an AI conversation.
  </Card>

  <Card title="Demonstrate Mode" icon="hand-pointer" href="/product/demonstrate-mode.md">
    Record workflows and get automation scripts automatically.
  </Card>

  <Card title="Studio" icon="code" href="/product/studio.md">
    Edit & debug in live browser enabled IDE and one-click deploy.
  </Card>
</CardGroup>

## Agent Tools

Empower your agents with secure credentials and authentic identities.

<CardGroup cols={2}>
  <Card title="Vaults" icon="lock" href="/concepts/vaults.md">
    Secure credential storage. Keep passwords, API keys, and sensitive data encrypted.
  </Card>

  <Card title="Identities" icon="fingerprint" href="/concepts/personas.md">
    Emails and phone numbers for agents. Verified identities to interact authentically across platforms.
  </Card>
</CardGroup>