Documentation

Build on Lisa OS.

The local-first AI desktop: install it, understand how it's put together, and write software against a system where intelligence is a service and privacy is a mechanism. alpha

Install

Flash the latest USB image and boot it — it runs from the stick, then installs to disk when you're ready.

# 1. Download lisa-usb-<version>.raw.zst from Releases, then:
zstd -d lisa-usb-*.raw.zst -o lisa.raw
sudo dd if=lisa.raw of=/dev/<your-usb> bs=4M status=progress oflag=sync

# 2. Boot it. To install onto the internal disk (erases it):
lisa install /dev/<internal-disk>

# 3. Update in place later (A/B, auto-rollback on a bad boot):
lisa update --reboot

→ Latest release & images

Learn

SDK

Intelligence is an OpenAI-compatible endpoint on the machine — build against it with zero Lisa-specific dependencies. Guided generation means typed output that always parses.

from openai import OpenAI
client = OpenAI(base_url="http://127.0.0.1:7777/v1", api_key="local")

r = client.chat.completions.create(
    model="lisa",
    messages=[{"role": "user", "content": "Extract the recipe.\n\n" + text}],
    response_format={"type": "json_schema",
                     "json_schema": {"name": "recipe", "schema": SCHEMA}})
# r.choices[0].message.content is always valid JSON for SCHEMA

→ Sample apps · Dart/Flutter SDK

Contribute

Lisa OS is GPL-2.0 and built entirely in the open. Issues, ideas, and patches welcome.