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
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
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
Lisa OS is GPL-2.0 and built entirely in the open. Issues, ideas, and patches welcome.