In this quickstart guide, we’ll create a simple web agent that can browse and interact with websites autonomously. You’ll learn how to set up your development environment, create a browser session, and run your first agent task.
The following script creates a session, attaches an agent to the session, and runs a basic task. Both session and agent have many parameters you can tweak.
Copy
Ask AI
from notte_sdk import NotteClientclient = NotteClient(api_key="your-key-here")# create a browser session resourcewith client.Session(headless=False) as session: # attach an agent to session agent = client.Agent( session=session, reasoning_model="gemini/gemini-2.0-flash", max_steps=5, ) # run the agent on a task response = agent.run( task="doom scroll cat memes on google images" )
Congratulations! This simple example demonstrates the core workflow - creating a session, attaching an agent, and giving it a task to execute. From here, you can explore more advanced features like custom reasoning models, session replay, and integrations with other AI tools. Check out our other guides to learn more about Notte.