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.
Val Town runs TypeScript HTTP handlers on Deno. The runnable example opens a Notte browser, reads a page title, and closes the session before returning JSON.

Set up

Create a val in Val Town, copy the example’s main.ts into a file, and add an HTTP trigger. In the val’s Environment Variables sidebar, set NOTTE_API_KEY from Notte. Set NOTTE_VALTOWN_TOKEN to a private invocation token you choose. Send a POST request to the trigger URL with Authorization: Bearer <NOTTE_VALTOWN_TOKEN>. The response contains title and the closed browser’s session_id. Unauthenticated requests cannot create browser sessions.

How it connects

The handler uses Deno’s built-in fetch with Notte’s session and page-execution APIs. The browser runs in Notte, so Val Town needs no browser binary or filesystem access. Cleanup runs on success and failure. The sample visits https://example.com; edit its task to browse another page. The example’s README includes offline and live verification commands. See Val Town’s environment variables guide for managing your keys. Verified locally with Deno 2.9.6 and real Notte browsers. Hosted Val Town execution has not been verified.