Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
docs: Add Notte integration guide
Co-authored-by: null <>
  • Loading branch information
tembo[bot] committed Oct 21, 2025
commit 83df1c3f2399d81ba54e9fd354352f667880c911
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -111,6 +111,7 @@
]
},
"integrations/magnitude",
"integrations/notte",
"integrations/stagehand",
"integrations/valtown",
"integrations/vercel"
Expand Down
111 changes: 111 additions & 0 deletions integrations/notte.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
---
title: "Notte"
---

[Notte](https://www.notte.cc/) is an AI agent framework that enables you to build sophisticated browser automation tasks. By integrating with Kernel, you can run Notte agents with cloud-hosted browsers using Chrome DevTools Protocol (CDP).

## Adding Kernel to existing Notte implementations

If you already have a Notte implementation, you can easily switch to using Kernel's cloud browsers by connecting via CDP.

### 1. Install the required SDKs

```bash
pip install notte-sdk kernel
```

### 2. Initialize Kernel and create a headless browser

Import the libraries and create a headless cloud browser session:

```python
from kernel import Kernel
from notte_sdk import NotteClient

# Initialize Kernel client
client = Kernel(api_key="your-api-key")

# Create a headless Kernel browser session
kernel_browser = client.browsers.create(headless=True)
```

### 3. Connect Notte to Kernel's CDP endpoint

Use Kernel's CDP WebSocket URL to create a Notte session:

```python
# Initialize Notte client
notte = NotteClient()

# Connect to Kernel browser via CDP
with notte.Session(cdp_url=kernel_browser.cdp_ws_url) as session:
# Create and run your agent
agent = notte.Agent(session=session, max_steps=5)
agent.run(task="extract pricing plans from https://www.notte.cc/")
```

### 4. Clean up the browser session

After your automation completes, tear down the Kernel browser:

```python
# Clean up
client.browsers.delete_by_id(kernel_browser.session_id)
```

## Complete example script

Here's a complete, runnable script that demonstrates the full integration:

```python
from kernel import Kernel
from notte_sdk import NotteClient

def main():
# Initialize clients
client = Kernel(api_key="your-api-key")
notte = NotteClient()

# Create a headless browser on Kernel
kernel_browser = client.browsers.create(headless=True)

try:
# Connect Notte to Kernel's browser via CDP
with notte.Session(cdp_url=kernel_browser.cdp_ws_url) as session:
# Create an agent with a task
agent = notte.Agent(session=session, max_steps=10)

# Run your automation task
result = agent.run(
task="Go to https://example.com and extract the main heading"
)

print(f"Task completed: {result}")

except Exception as e:
print(f"Error during automation: {e}")

finally:
# Always clean up the browser session
client.browsers.delete_by_id(kernel_browser.session_id)
print("Browser session cleaned up")

if __name__ == "__main__":
main()
```

## Benefits of using Kernel with Notte

- **No local browser management**: Run agents without installing or maintaining browsers locally
- **Headless execution**: Perfect for server environments and CI/CD pipelines
- **Scalability**: Launch multiple browser sessions in parallel for concurrent tasks
- **Cloud infrastructure**: Leverage Kernel's optimized browser infrastructure
- **Stealth mode**: Built-in anti-detection features for web scraping
- **Session control**: Programmatic control over browser lifecycle

## Next steps

- Learn about [creating browsers](/browsers/create-a-browser) on Kernel
- Check out [live view](/browsers/live-view) for debugging your automations
- Learn about [stealth mode](/browsers/stealth) for avoiding detection
- Explore [session persistence](/browsers/persistence) for maintaining browser state
1 change: 1 addition & 0 deletions integrations/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ Kernel provides detailed guides for popular agent frameworks:

- **[Browser Use](/integrations/browser-use)** - AI browser agent framework
- **[Stagehand](/integrations/stagehand)** - AI browser automation with natural language
- **[Notte](/integrations/notte)** - AI agent framework for sophisticated browser automation
- **[Computer Use (Anthropic)](/integrations/computer-use/anthropic)** - Claude's computer use capability
- **[Computer Use (OpenAI)](/integrations/computer-use/openai)** - OpenAI's computer use capability
- **[Magnitude](/integrations/magnitude)** - Vision-focused browser automation framework
Expand Down