Skip to main content
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.
Run Notte browser tasks as Temporal Activities. The TypeScript project in examples/temporal in the Notte repository reads a page title through Playwright and returns the result to a Workflow.

Set up

Use Node.js 24+, a Notte API key, and the Temporal CLI. Clone the Notte repository and open examples/temporal. Use three terminals:
  1. Start the local server with temporal server start-dev.
  2. Run npm ci and npm run build, set NOTTE_API_KEY to your Notte API key, then run npm run worker.
  3. Run npm start. The result contains title: "Example Domain" and the stopped session’s session_id.

Retries and browser ownership

Browser calls run inside the Activity, outside deterministic Workflow code. Each attempt creates a new session and closes it on success or failure. A three-minute session limit bounds browser lifetime if the worker process dies before cleanup. No local browser installation is needed. The Workflow allows up to three Activity attempts. Keep operations with external side effects out of automatic retries unless they are idempotent.