Quickstart

Install Libretto and run your first workflow end to end.

Agent prompt

Fetch and follow https://libretto.sh/start.md to set up Libretto and create a new browser automation.

Manual

1. Choose a setup path

   Decide whether you want to create a new Libretto package or add Libretto to an existing Node.js package.

   If you create a new package, choose where it should live and what it should be named. If you use an existing package, switch into that package directory before installing Libretto.
2. Option A: create a new Libretto package

   From the directory where the new package should be created:

   1npm create libretto@latest

   You can pass a package name directly:

   1npm create libretto@latest my-automations

   This scaffolds a package, installs dependencies, runs setup, and downloads Chromium.
3. Option B: add Libretto to an existing package

   From the existing package directory, add Libretto as a dependency and run setup:

   12npm install libretto zod
   npx libretto setup

   Then create a workflow file and run it with npx libretto run <path> --headless.
4. Create and run a smoke workflow

   Create src/workflows/scrape-page.ts in the package you set up:

   src/workflows/scrape-page.ts

   12345678910111213141516171819import { workflow } from "libretto";
   import { z } from "zod";
   
   export default workflow(
     "scrape-page",
     {
       input: z.object({}),
       output: z.object({
         title: z.string(),
       }),
       startUrl: "https://example.com",
     },
     async ({ page }) => {
       const title = await page.title();
       console.log(`Page title: ${title}`);
   
       return { title };
     },
   );

   Run it headless:

   1npx libretto run src/workflows/scrape-page.ts --headless

   This confirms your local setup works and shows the basic run loop.

Compare browser automation tools