Lyst

Listen, Rezepte und Notizen für den Haushalt.

Einkaufszettel in einer App, Rezepte in der zweiten, Notizen in der dritten — und nichts spricht miteinander. Lyst legt alles zusammen: Listen, Rezepte und Notizen für deinen Haushalt, in Echtzeit auf allen Geräten.

Und weil ich KI nützlich finde, aber niemandem meine Einkaufszettel schicken will, läuft sie lokal: ein Ollama auf deiner eigenen Hardware kategorisiert Einträge, importiert Rezepte und beantwortet „Was kann ich kochen?“.

laarsv/Lyst

Was es kann

Einkaufs-, Pack- und Checklisten mit Vorlagen; „200g Käse“ wird beim Massen-Hinzufügen automatisch in Menge und Artikel zerlegt
Echtzeit-Sync zwischen allen Geräten über WebSocket
Listen teilen: Mitnutzer mit Lese- oder Schreibrechten, öffentliche Read-only-Links mit QR-Code
Rezept-Import per URL oder Foto, Portionsskalierung, Nährwerte pro Portion, Cook-Mode in Vollbild
Wochenplan mit Ein-Klick-Einkaufsliste; Zutaten wandern direkt auf die Liste
Notizen mit Markdown, Tabellen, Aufgabenlisten, [[Wikilinks]] und Versionsverlauf
Offline-fähig als PWA: Änderungen warten in einer lokalen Queue und syncen, sobald du wieder online bist
Mehrbenutzer mit Admin-Bereich und E-Mail-Einladungen; deutsche UI, Dark Mode

KI, die zu Hause bleibt

Standardmäßig spricht Lyst mit einer lokalen Ollama-Instanz: Auto-Kategorisierung von Einkaufsartikeln, Rezept-Import aus URL oder Foto, Kochvorschläge aus vorhandenen Zutaten. Damit die erste Antwort nicht eine halbe Minute dauert, hält Lyst das Textmodell per keep_alive dauerhaft im RAM und wärmt es beim Start vor.

Kein Ollama? Dann funktioniert schlicht alles andere weiter. Alternativ hinterlegst du einen Anthropic-Key und nutzt Claude als Cloud-Variante — deine Entscheidung, pro Instanz umschaltbar.

Selbst hosten

Dein Server, deine Daten.

Das brauchst du

Docker ≥ 24 mit Compose v2; rund 1 GB RAM für den Stack aus Postgres, Backend und Frontend
Läuft auf Mini-PC, NAS oder günstigem VPS — die Images gibt es für amd64 und arm64
Optional Ollama: ab einem 16-GB-Mini-PC ist Text flott; für Foto-Import lohnt eine GPU oder Apple Silicon

So läuft es an

Klonen und konfigurieren

git clone https://github.com/laarsv/Lyst.git && cd Lyst
cp .env.example .env

2

.env füllen

Pflicht sind POSTGRES_PASSWORD, SECRET_KEY (openssl rand -hex 32) und die initialen Admin-Zugangsdaten — fehlt eine Variable, bricht der Start bewusst hart ab.
3
Starten

Migrationen und der Admin-User werden beim ersten Start automatisch angelegt.
```
docker compose up -d
curl -fsS http://localhost:8091/api/health
```
4

Anmelden und absichern

http://localhost:8091 öffnen, mit den Admin-Zugangsdaten anmelden — und als Erstes das Passwort ändern. Für HTTPS brauchst du einen Reverse-Proxy mit WebSocket-Support.

Steckbrief

Stack: FastAPI · PostgreSQL 16 · React + TypeScript · Ollama
KI: lokal via Ollama, optional Anthropic Claude
Lizenz: AGPL-3.0