run

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.

with notte.Session() as session:
    agent = notte.Agent(session=session)
    agent.run(task="go to notte.cc and explain what their product is")

This function is synchronous and will block the main thread until the agent is completed.

Websockets are used to stream the agent logs to the standard output to provide live logs to the user.

Parameters

str

required

The task description to execute (required).

str | None

Optional URL to process, defaults to None.

type[pydantic.main.BaseModel] | None

The response format to use for the agent answer. You can use a Pydantic model or a JSON Schema dict.

int | None

[Experimental] The step from which the agent should gather information from in the session. If none, fresh memory

Returns

AgentStatusResponse: The final status response after task completion.

Raises

TimeoutError: If the agent doesn’t complete within the maximum allowed attempts.

⌘I

Getting Started

APIs

Python SDK

Node SDK

Parameters

Returns

Raises

​Parameters

​Returns

​Raises

Parameters

Returns

Raises