Willkommen bei Liberino AI
Das umfassende Wissens- und Dokumentationsportal für multimodale Buchwelten, Lore-Kontinuität und Agentic RAG
Liberino AI Dokumentation
Willkommen im zentralen Dokumentationsportal von Liberino AI und dem Kernsystem LoreKeeper.
Dieses Portal ist in zwei klar voneinander getrennte Bereiche gegliedert:
- Ein allgemein verständlicher Teil ganz oben – für alle, die das Gesamtkonzept, den Nutzen, die Funktionsweise und die Vor- und Nachteile verstehen möchten (Produktmanager, Verlage, Autor:innen und Leser:innen).
- Ein fundierter technischer Teil – für Entwickler:innen, Architekt:innen und DevOps mit Systemdiagrammen, Pipeline-Algorithmen und einer vollständig interaktiven Swagger UI.
🧭 Wähle deinen Einstieg
💡 1. Allgemein verständlicher Teil (Konzept & Vision)
Kein Programmcode: Was ist das Projekt, wie funktioniert es Schritt für Schritt, was ist ein Lore-System und welche Vor- und Nachteile gibt es?
🛠️ 2. Technischer Teil (Architektur & Pipelines)
Für Entwickler: Fastify v5, Directus SDK, unüberwachte Bildsegmentierung, Gemini 3 Flash, LiteLLM und Bitemporalität.
🚀 3. Interaktive Swagger UI & API-Referenz
Alle 22 Endpunkte direkt im Browser live testen, Schemata analysieren und Requests absenden.
🌟 4. Fallstudien & Praxisbeispiele
Echte Buchprojekte: Vom Kinderbuch mit Janosch-Stil bis zum epischen Fantasy-Zyklus mit Magiegesetzen.
📖 Teil 1: Grundlagen, Konzept & Mehrwert (Allgemein verständlich)
Entwickelt für Autor:innen, Lektor:innen, Verlage und Produkt-Teams, die verstehen wollen, wie Liberino AI Bücher lebendig macht.
Was ist Liberino AI?
Die Vision: Warum normale KIs an Büchern scheitern und wie Liberino das Buchlesen revolutioniert.
Wie funktioniert das Gesamtsystem?
Der 5-Schritte-Weg: Vom Hochladen des Manuskripts bis zur konsistent generierten Szene.
Was ist ein Lore-System (Weltengedächtnis)?
Bitemporale Zustände: Warum Figuren Narben behalten und wie KI-Amnesie verhindert wird.
Vorteile & Mehrwert
Absolute Kanontreue, multimodale Bild-Text-Harmonie, Zeitersparnis und Personalisierung.
Herausforderungen & Grenzen
Ehrliche Analyse von Multi-Agent-Latenzen, API-Kosten, Text-Ambiguitäten und Bildstil-Brüchen.
Fachliche Konzeption: Universen & Stile
Worldbuilding, Kanon-Regeln, bitemporale Lore-Zustände und modulare Stilvorlagen.
⚙️ Teil 2: Technische Dokumentation (Für Entwickler & DevOps)
Tiefgehende technische Architektur, relationale Schemata, ReAct Agent Loops und Microservices.
Systemarchitektur & Stack
Fastify v5 ESM, Directus Headless CMS, LiteLLM Gateway, KeyDB Redis Cache und Docker Orchestrierung.
Universelle Book-Ingestion Pipeline
2-Phasen Ingestion: Globale semantische Textanalyse & unüberwachtes Bild-Clustering.
ReAct Agentic Loop & Tool Execution
Multi-Hop State Machine, Intent Routing und deterministische Directus Tool-Calls.
KI-Orchestrierung via LiteLLM
Gemini 3 Flash (Vision-Model), Gemini 2.5 Pro (Writer) und Gemini 2.5 Flash (Router).
Datenbank-Schema & Relationen
PostgreSQL-Tabellen, Indizes, Relationen und bitemporale State-Patches.
Kritische Systemanalyse
Latenz-Analyse, 5-Hop-Falle, Ausfallsicherheit und Token-Budgets.
⚡ Teil 3: API & Schnittstellen (OpenAPI 3.1 & Swagger)
Umfassende Schnittstellendokumentation für die Integration in E-Reader, Web-Frontends und Publishing-Systeme.
🚀 Live Swagger UI Explorer
Interaktiver Swagger 3.1 Tester direkt in Fumadocs mit Live-Ausführung.
API-Übersicht & Fehlerformate
Globale Standards, Validierungsfehler, Download-Links für openapi.json und openapi.yaml.
Buch-Ingestion & Status APIs
/api/books/ingest, /upload, /status und /export Schnittstellen.
Entitäten, Bounding-Boxes & Rollen
Multimodale Extraktion, /refine-bbox, /tier Promotion und /crops Abfragen.
Szenen-Generierung & Audit
Agentic RAG Textgenerierung (/api/scenes/generate) und Kanon-Audits (/api/scenes/audit).
Autonomer Agent & Chat
ReAct-Chat (/api/agent/chat) und dynamische Tool-Ausführung (/tools/execute).