Libretto: A Toolkit for Web Integration and Automation

Libretto is a powerful toolkit designed to streamline web integrations by providing a live browser and a token-efficient CLI. It allows developers to inspect live pages, capture network traffic, record and replay user actions, and debug workflows directly against real sites. Created by Saffron Health, Libretto is particularly useful for maintaining browser integrations with common healthcare software. By open-sourcing this tool, we aim to assist other teams in achieving similar integration efficiency.

## Installation and Setup

To get started with Libretto, install it using npm and set it up with npx. The setup process includes installing necessary skills, downloading Chromium, and configuring the default snapshot model. The tool supports multiple AI providers like OpenAI, Anthropic, Gemini, and Vertex, allowing users to switch providers or set custom models as needed.

## Use Cases

Libretto excels in various scenarios, such as generating one-shot scripts for data scraping, building interactive scripts for specific workflows, converting browser automation to network requests, and fixing broken integrations. For instance, it can automate tasks like scraping LinkedIn posts or converting browser scripts into direct API calls for efficiency and reliability.

## CLI Usage and Configuration

The CLI offers commands for setting up, checking configurations, launching browsers, executing scripts, and managing sessions. Configuration details are stored in a .libretto directory, with options to adjust AI models and viewport settings. Sessions and profiles help manage runtime states and save authenticated browser sessions for reuse.

## Community and Development

Libretto encourages community engagement through Discord and GitHub Discussions, where users can ask questions, suggest features, and share their workflows. The tool is maintained by Saffron Health, with development facilitated through pnpm for local builds, testing, and synchronization of documentation and skills.