Start

Quickstart — npx

Run the same studio from one command, in a browser tab, with nothing installed.

Run it

One command, no install step. Libi serves the studio locally; open the URL yourself — it does not launch a browser for you.

The first run sets up ~/.libi/ and downloads the binaries and models Libi needs, which takes a few minutes and prints its progress. After that, startup is quick.

Start the studio

npx @nagellabs/libi

# then open:
# http://localhost:3456

Flags and environment

Everything the command accepts. --connect-agent is the one that changes what Libi is for; it has its own page.

--port 4000 — serve somewhere other than the default 3456.
--connect-agent [dir] — run headless and hand Libi's tools to your own CLI agent instead. See Bring your own CLI.
LIBI_HOME=/path/to/dir — put the workspace somewhere other than ~/.libi.
LIBI_DEBUG=1 — verbose MCP transport logging, for when something isn't talking to something else.

Examples

npx @nagellabs/libi --port 4000
LIBI_HOME=~/work/libi npx @nagellabs/libi

Closing it down

Stop the process and the studio is gone. Your projects and media are not — they live in ~/.libi/, and the next npx @nagellabs/libi, or the desktop app, picks up exactly where you left off.

← previous

Quickstart — Desktop

Quickstart — CLI

was this helpful? open an issue or PRedit on github →