Skip to content

Commit 83df1c3

Browse files
committed
docs: Add Notte integration guide
Co-authored-by: null <>
1 parent 3e1d7f5 commit 83df1c3

File tree

3 files changed

+113
-0
lines changed

3 files changed

+113
-0
lines changed

docs.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,7 @@
111111
]
112112
},
113113
"integrations/magnitude",
114+
"integrations/notte",
114115
"integrations/stagehand",
115116
"integrations/valtown",
116117
"integrations/vercel"

integrations/notte.mdx

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
---
2+
title: "Notte"
3+
---
4+
5+
[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).
6+
7+
## Adding Kernel to existing Notte implementations
8+
9+
If you already have a Notte implementation, you can easily switch to using Kernel's cloud browsers by connecting via CDP.
10+
11+
### 1. Install the required SDKs
12+
13+
```bash
14+
pip install notte-sdk kernel
15+
```
16+
17+
### 2. Initialize Kernel and create a headless browser
18+
19+
Import the libraries and create a headless cloud browser session:
20+
21+
```python
22+
from kernel import Kernel
23+
from notte_sdk import NotteClient
24+
25+
# Initialize Kernel client
26+
client = Kernel(api_key="your-api-key")
27+
28+
# Create a headless Kernel browser session
29+
kernel_browser = client.browsers.create(headless=True)
30+
```
31+
32+
### 3. Connect Notte to Kernel's CDP endpoint
33+
34+
Use Kernel's CDP WebSocket URL to create a Notte session:
35+
36+
```python
37+
# Initialize Notte client
38+
notte = NotteClient()
39+
40+
# Connect to Kernel browser via CDP
41+
with notte.Session(cdp_url=kernel_browser.cdp_ws_url) as session:
42+
# Create and run your agent
43+
agent = notte.Agent(session=session, max_steps=5)
44+
agent.run(task="extract pricing plans from https://www.notte.cc/")
45+
```
46+
47+
### 4. Clean up the browser session
48+
49+
After your automation completes, tear down the Kernel browser:
50+
51+
```python
52+
# Clean up
53+
client.browsers.delete_by_id(kernel_browser.session_id)
54+
```
55+
56+
## Complete example script
57+
58+
Here's a complete, runnable script that demonstrates the full integration:
59+
60+
```python
61+
from kernel import Kernel
62+
from notte_sdk import NotteClient
63+
64+
def main():
65+
# Initialize clients
66+
client = Kernel(api_key="your-api-key")
67+
notte = NotteClient()
68+
69+
# Create a headless browser on Kernel
70+
kernel_browser = client.browsers.create(headless=True)
71+
72+
try:
73+
# Connect Notte to Kernel's browser via CDP
74+
with notte.Session(cdp_url=kernel_browser.cdp_ws_url) as session:
75+
# Create an agent with a task
76+
agent = notte.Agent(session=session, max_steps=10)
77+
78+
# Run your automation task
79+
result = agent.run(
80+
task="Go to https://example.com and extract the main heading"
81+
)
82+
83+
print(f"Task completed: {result}")
84+
85+
except Exception as e:
86+
print(f"Error during automation: {e}")
87+
88+
finally:
89+
# Always clean up the browser session
90+
client.browsers.delete_by_id(kernel_browser.session_id)
91+
print("Browser session cleaned up")
92+
93+
if __name__ == "__main__":
94+
main()
95+
```
96+
97+
## Benefits of using Kernel with Notte
98+
99+
- **No local browser management**: Run agents without installing or maintaining browsers locally
100+
- **Headless execution**: Perfect for server environments and CI/CD pipelines
101+
- **Scalability**: Launch multiple browser sessions in parallel for concurrent tasks
102+
- **Cloud infrastructure**: Leverage Kernel's optimized browser infrastructure
103+
- **Stealth mode**: Built-in anti-detection features for web scraping
104+
- **Session control**: Programmatic control over browser lifecycle
105+
106+
## Next steps
107+
108+
- Learn about [creating browsers](/browsers/create-a-browser) on Kernel
109+
- Check out [live view](/browsers/live-view) for debugging your automations
110+
- Learn about [stealth mode](/browsers/stealth) for avoiding detection
111+
- Explore [session persistence](/browsers/persistence) for maintaining browser state

integrations/overview.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ Kernel provides detailed guides for popular agent frameworks:
1919

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

0 commit comments

Comments
 (0)