Dokumentation

Willkommen! JuStAI macht aus günstigen Netzwerkkameras, Mikrofonen, Lautsprechern und Bildschirmen einen lokalen KI-Assistenten für jeden Raum. Such dir den Weg, der zu dir passt.

Finde deinen Weg

Ich will es ausprobierenEin Befehl, etwa 15 Minuten, ohne Programmieren.

Was kann ich fragen?Echte Beispielgespräche als Ideengeber.

Ich will mitbauenPlugins und Änderungen per Vibe Coding.

Ich will wissen, wie es funktioniertArchitektur, Technik und Entscheidungen.

1. Loslegen

Überblick

Was JuStAI ist, was es kann und wie die Teile zusammenspielen. Überblick lesen

Installation

Vom leeren Linux-PC zum ersten Gespräch. Schritt für Schritt installieren

2. Zuhause einrichten

Einmal erledigen, in dieser Reihenfolge.

Räume

Räume, Interaction Endpoints und wohin Antworten gehen. Räume

Kameras und Geräte

Kameras, Mikrofone und Lautsprecher hinzufügen. Geräte

Bildschirme und Geräte-App

Handys, Tablets und TVs als Bildschirm, Mikrofon und Lautsprecher. Displays

Sprache und Wakeword

Wakeword, Echo-Behandlung und Sprechen ohne Pause. Audio

3. Täglich nutzen

KI-Modelle und Sprachen

Gemini, Ollama, Fallback, Datenschutzregeln und Kosten. KI

Sehen und Erkennen

Personen, Tiere, Objekte und Zustandsdetektoren. Vision

Bewegliche Kameras

Schwenken, Neigen, Zoom und Privatmodus. PTZ

Gedächtnis

Was der Assistent sich merkt und vergisst. Gedächtnis

Automationen

Dinge tun, wenn etwas passiert. Automationen

4. Erweitern

Vibe Coding

JuStAI mit einem KI-Coding-Assistenten weiterbauen. Loslegen

Plugins

Manifest, Berechtigungen, Sandbox und SDK. Plugins

5. Betreiben und absichern

Betrieb

Updates, Backups, Ports, TLS und lokale KI mit Ollama. Betrieb

Sicherheit und Datenschutz

Was zu Hause bleibt und wie Daten geschützt werden. Sicherheit

6. Unter der Haube

Architektur

Container, Module und Datenfluss. Architektur

Technik-Stack

Jede Bibliothek und warum sie gewählt wurde. Technik-Stack

Entwicklung und Tests

Entwicklungsumgebung einrichten und Tests ausführen. Entwicklung · Tests

Entscheidungen (ADR)

Warum die Dinge so sind, wie sie sind. ADRs

Hilfe nötig?

Fragen und Ideen gehören in die GitHub Discussions, Fehler und Feature-Wünsche in die GitHub Issues.