Docs: Add Notte Integration

[tembo]

Description

Adds Notte integration to the Integration Guides section, detailing how to use Kernel's cloud browsers with Notte via CDP.

Implementation Checklist

• If updating our sample apps, update the info in our Quickstart
• If updating our CLI, update the info in our CLI

Testing

• mintlify dev works (see installation here)

Docs

• Link to a PR in our docs repo documenting your change (if applicable)

Visual Proof

Please provide a screenshot or video demonstrating that your changes work locally:

[Drag and drop your screenshot/video here or use the following format:]
[]

Related Issue

Fixes [Github issue link]

[If this corresponds to a fix from another Kernel OSS repo, include this:]

Fixes [Link to other repo]

[Replace with actual issue link, e.g., Fixes https://github.com/username/repo/issues/123]

Additional Notes

[Any additional context, concerns, or notes for reviewers]

Want me to make any changes? Add a review or comment with @tembo and i'll get back to work!

[tembo]

Requesting review from @juecd who has experience with the following files modified in this PR:

• docs.json
• integrations/overview.mdx

[mesa-dot-dev]

Mesa Description

Description

Adds a new integration guide for using the Notte AI agent framework with Kernel's cloud browsers.

• Creates a new documentation page (integrations/notte.mdx) with setup instructions and a Python example for connecting via the Chrome DevTools Protocol (CDP).
• Updates the main integrations overview page to include Notte.
• Adds the new page to the site's navigation structure in docs.json.

Implementation Checklist

• If updating our sample apps, update the info in our Quickstart
• If updating our CLI, update the info in our CLI

Testing

• mintlify dev works (see installation here)

Docs

• Link to a PR in our docs repo documenting your change (if applicable)

Visual Proof

Please provide a screenshot or video demonstrating that your changes work locally:

[Drag and drop your screenshot/video here or use the following format:]
[]

Related Issue

Fixes [Github issue link]

[If this corresponds to a fix from another Kernel OSS repo, include this:]

Fixes [Link to other repo]

[Replace with actual issue link, e.g., Fixes https://github.com/username/repo/issues/123]

Additional Notes

[Any additional context, concerns, or notes for reviewers]

^{Description generated by Mesa. Update settings}

[mesa-dot-dev]

Performed full review of 3e1d7f5...83df1c3

Analysis

1. The PR focuses on documentation only with no actual implementation code, which may make it difficult to verify if the documented integration patterns actually work as described.

2. While leveraging CDP (Chrome DevTools Protocol) provides integration capabilities, there's no mention of potential performance impacts or limitations when connecting Notte AI with Kernel's cloud browsers.

3. The documentation may need additional sections on troubleshooting common integration issues, as the current focus appears to be on the happy path implementation.

4. There's no indication of version compatibility requirements or potential future API changes that could impact the integration's stability.

Tip

⚡ Quick Actions

This review was generated by Mesa.

Actions:

• Configure your agents

Slash Commands:

• /review - Request a full code review
• /review latest - Review only changes since the last review
• /describe - Generate PR description. This will update the PR body or issue comment depending on your configuration
• /help - Get help with Mesa commands and configuration options

^{3 files reviewed | 0 comments | Review on Mesa | Edit Reviewer Settings}

[dprevoznik]

@tembo can you do the following:

1. please use this as the complete example instead (and use this to inform the snippets above):

from kernel import Kernel
from notte_sdk import NotteClient
import os
from dotenv import load_dotenv

Load environment variables from .env file

load_dotenv()

def main():
# Initialize clients
kernel_api_key = os.getenv("KERNEL_API_KEY")
notte_api_key = os.getenv("NOTTE_API_KEY")

if not kernel_api_key:
    raise ValueError("KERNEL_API_KEY not found in environment variables")
if not notte_api_key:
    raise ValueError("NOTTE_API_KEY not found in environment variables")

kernel_client = Kernel(api_key=kernel_api_key)
notte_client = NotteClient(api_key=notte_api_key)

# Create a headful browser on Kernel
print("Creating browser session on Kernel...")
kernel_browser = kernel_client.browsers.create(headless=False)
# print(kernel_browser.browser_live_view_url)

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

        # Run your automation task
        result = agent.run(
            task="extract pricing plans from https://www.notte.cc"
        )

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

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

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

if name == "main":
main()

2. Do uv pip install notte-sdk kernel for installation

3. For overview, just have it say as the description: "AI agent framework for browser automation" and move it just before Val Town in the list

4. You can leave it's place on the sidebar nav

[tembo]

@tembo can you do the following:

1. please use this as the complete example instead (and use this to inform the snippets above):

from kernel import Kernel
from notte_sdk import NotteClient
import os
from dotenv import load_dotenv

Load environment variables from .env file

load_dotenv()

def main():
# Initialize clients
kernel_api_key = os.getenv("KERNEL_API_KEY")
notte_api_key = os.getenv("NOTTE_API_KEY")

if not kernel_api_key:
    raise ValueError("KERNEL_API_KEY not found in environment variables")
if not notte_api_key:
    raise ValueError("NOTTE_API_KEY not found in environment variables")

kernel_client = Kernel(api_key=kernel_api_key)
notte_client = NotteClient(api_key=notte_api_key)

# Create a headful browser on Kernel
print("Creating browser session on Kernel...")
kernel_browser = kernel_client.browsers.create(headless=False)
# print(kernel_browser.browser_live_view_url)

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

        # Run your automation task
        result = agent.run(
            task="extract pricing plans from https://www.notte.cc"
        )

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

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

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

if name == "main":
main()

2. Do uv pip install notte-sdk kernel for installation

3. For overview, just have it say as the description: "AI agent framework for browser automation" and move it just before Val Town in the list

4. You can leave it's place on the sidebar nav

Thanks for the requested changes! I've updated the Notte integration guide with your complete example, changed the installation command to use uv pip, revised the description to "AI agent framework for browser automation", and moved it before Val Town in the list.

[dprevoznik]

@tembo for the existing script conversion steps only, can you simplify and remove some of the actual logic to get the API keys (just write placeholders as you original did) + remove the try except logic.

Try to closely mimic the shortness here: https://docs.notte.cc/features/sessions/cdp#use-external-session-provider-via-cdp using only the required pieces to get a Kernel browser up and running with Notte agent

[tembo]

@tembo for the existing script conversion steps only, can you simplify and remove some of the actual logic to get the API keys (just write placeholders as you original did) + remove the try except logic.

Try to closely mimic the shortness here: https://docs.notte.cc/features/sessions/cdp#use-external-session-provider-via-cdp using only the required pieces to get a Kernel browser up and running with Notte agent

I've simplified the Notte integration script as requested, removing the error handling and API key logic in favor of placeholder values. The changes closely follow the minimalist approach of the Notte docs example, focusing only on the essential steps needed to get a Kernel browser working with the Notte agent. I've kept the code straightforward and brief throughout all sections.

[dprevoznik]

@tembo please remove the written benefit of headless browsers as we aren't using that

[tembo]

@tembo please remove the written benefit of headless browsers as we aren't using that

Removed the "Headless execution" benefit line from the document as requested. The benefits section now focuses only on cloud infrastructure, scalability, and other relevant Kernel advantages without mentioning headless browsers.

[dprevoznik]

@tembo and remove the "notte-sdk" mention in the required SDKs, so just this:

"uv pip install kernel"

[tembo]

@tembo and remove the "notte-sdk" mention in the required SDKs, so just this:

"uv pip install kernel"

Thanks @dprevoznik - I've removed the "notte-sdk" mention in the installation command as requested, so it now only shows "uv pip install kernel". The Notte SDK would be installed separately by users according to their own requirements.