boat

AI agent instructions

Read the Notte skill 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.

boat runs agents in full Linux VMs that keep their disk between runs. Pair it with Notte when an agent builds or runs an app in a sandbox and needs a browser to check the result, or when it browses sites that block or challenge a datacenter IP. A Notte browser comes with stealth, residential proxies and captcha solving. See the runnable Python example.

Set up

Use Python 3.11+, a boat API key, and a Notte API key. Install boat-sdk, notte-sdk[playwright], and python-dotenv.

Open a sandbox app from your code

Serve the app from the sandbox, then host its port. The hosted URL carries an access token, so the browser needs no auth header; treat it like a password. session.page is a Playwright page connected to the Notte browser over CDP.

import os

from boat_sdk import ApiClient, Configuration, exec_command, wait_until_ready, write_text
from boat_sdk.api.boat_api import BoatApi
from boat_sdk.models import CommandRequest, CreateSandboxRequest, HostPortRequest
from notte_sdk import NotteClient

notte = NotteClient()
config = Configuration(host="https://boat.dev/api/v1", access_token=os.environ["BOAT_API_KEY"])
with ApiClient(config) as client:
    boat = BoatApi(client)
    sandbox_id = boat.create(create_sandbox_request=CreateSandboxRequest(ttl_seconds=1800)).sandbox.id
    try:
        wait_until_ready(boat, sandbox_id)
        write_text(boat, sandbox_id, "app/index.html", "<h1>Hello from boat</h1>")
        boat.command(sandbox_id, CommandRequest(command="python3 -m http.server 8000", cwd="app", detached=True))
        # Wait until the server accepts connections.
        exec_command(boat, sandbox_id, "for i in $(seq 1 50); do curl -sf localhost:8000 > /dev/null && exit 0; sleep 0.2; done; exit 1")
        url = boat.host_port(sandbox_id, HostPortRequest(port=8000)).url

        with notte.Session() as session:
            page = session.page
            page.goto(url)
            print(page.locator("h1").inner_text())
    finally:
        boat.delete_sandbox(x_ascii_confirm_delete=sandbox_id, sandbox_id=sandbox_id)

Drive the browser from inside the sandbox

Agents running in the sandbox can use the Notte CLI. Pass NOTTE_API_KEY in the sandbox’s env when you create it, then install the CLI and the Notte skills, which coding agents such as Claude Code and Codex pick up from ~/.agents/skills:

curl -fsSL https://notte.cc/install-cli.sh | sh
notte skill add --yes

Then drive the browser. Replace the example URL with the one host_port returns:

notte sessions start
notte page goto 'https://<sandbox>-8000.on.boat.dev?_token=<token>'
notte page fill '#title' 'Ship the boat example'
notte page click 'button[type=submit]'
notte page scrape --only-main-content
notte sessions stop --yes

The example stops the CLI session even when a command fails, and deletes the sandbox at the end. Its tests cover the sandbox commands and cleanup offline, and the full flow against real boat and Notte.

Integrations

Coding Agents

Agent Frameworks

Computer Use

Workflow Automation

Observability

Payments

File Storage

Email

Databases

Testing

Credentials

Browser Drivers

Infrastructure as Code

Browser Infrastructure

Set up

Open a sandbox app from your code

Drive the browser from inside the sandbox

​Set up

​Open a sandbox app from your code

​Drive the browser from inside the sandbox

Set up

Open a sandbox app from your code

Drive the browser from inside the sandbox