from notte_sdk import NotteClient

notte = NotteClient()
task = "find a cute dog on google images"

with notte.Session() as session:
    agent = notte.Agent(session=session, max_steps=5)
    # this runs the agent and waits for completion
    full_response = agent.run(task=task)
    print(f"{full_response.success=}, {full_response.answer=}")

import { NotteClient } from "notte-sdk";

const notte = new NotteClient();
const task = "find a cute dog on google images";

await notte.Session().use(async (session) => {
  const agent = notte.Agent({ session, max_steps: 5 });
  // this runs the agent and waits for completion
  const response = await agent.run({ task });
  console.log(`success=${response.success}, answer=${response.answer}`);
});

curl -X POST "https://api.notte.cc/agents/start" \
-H "Authorization: Bearer $NOTTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"task": "task",
"url": null,
"response_format": null,
"session_offset": null,
"reasoning_model": "vertex_ai/gemini-2.5-flash",
"use_vision": true,
"max_steps": 20,
"vault_id": null,
"persona_id": null,
"notifier_config": null,
"session_id": "<session_id>"
}'

{
  "agent_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "session_id": "<string>",
  "closed_at": "2023-11-07T05:31:56Z",
  "saved": false
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}