Open source · GNU/Linux · Fully offline

Your cosmic
companion.

Lyra is a local AI assistant that lives on your machine, not in someone else's cloud. It runs a lightweight language model entirely offline, learns your distro and package manager, and answers with the exact command your system needs — not a generic one.

Runs fully offline — your data stays yours
4 GB RAM. Full AI. No compromises
Free, open source, and yours to keep

Install Lyra View the code

Lyra, the project's astronaut mascot, floating

Under the hood

Three parts, one assistant.

Lyra is built as a small constellation of its own: a backend that thinks, a client that you talk to, and packaging that gets it onto your system in the first place.

The brain

lyra-server

Backend daemon for Lyra. Exposes a Unix socket for the CLI and desktop UI, plus an HTTP API with streaming for external integrations.

Runs a local Qwen2.5-1.5B model via llama-cpp-python
Remembers past conversations with a semantic memory store
Resolves packages across pacman, apt, PyPI, npm, crates.io

Stack Python 3.13 · FastAPI · llama-cpp-python · SQLite · ChromaDB

The face

lyra-ui

The Electron desktop client. Talks to lyra-server over a Unix socket, renders responses as markdown, and keeps an eye on your system.

Renders responses as markdown with syntax highlighting
Shows live RAM, CPU, and disk usage
Starts lyra-server automatically if it isn't already running

Stack Electron · Node.js 20 · pnpm · markdown-it · Chart.js

The delivery

lyra-packaging

The packaging and release pipeline that turns lyra-server and lyra-ui into installable packages for your distribution.

Builds .pkg.tar.zst archives for Arch Linux
Builds .deb archives for Debian and Ubuntu
Handles CI/CD and release announcements

Stack Shell · Python · GitHub Actions

Where it runs

Supported distributions

Distribution	Package manager	Status
Arch Linux and derivatives	`pacman`	Supported
Debian, Ubuntu and derivatives	`apt`	Supported

What it needs

System requirements

	Minimum	Recommended
RAM	4 GB	8 GB
Disk	3 GB free	5 GB free
CPU	x86_64, 2 cores	x86_64, 4 cores
GPU	Not required	NVIDIA, AMD, or Intel Arc

Estimates based on Lyra's bundled components; not yet formally benchmarked.

Get started

Install Lyra

Arch Linux

sudo pacman -U lyra-1.1.0-1-x86_64.pkg.tar.zst

Debian / Ubuntu

sudo apt install ./lyra_1.1.0-1_amd64.deb

Then, download the model once — this needs an internet connection the first time only:

lyra-install-backend

Start it up:

lyra serve --daemon
lyra-ui

Or skip the desktop client and talk to it from the terminal:

lyra -q "how do I install neovim"

Your cosmiccompanion.