Modulare Basis
Analyse, chess_eval, database, player_profile, knowledge, queue, training, agent und hardware sind als Bausteine vorhanden.
Repository-Stand
Vier Repos, ein System.
CaiLama ist bewusst auf getrennte Verantwortlichkeiten geschnitten: Produktkern, LLM-Infrastruktur, Search/RAG-Dienst und Master-Doku.
CaiLama
Das Hauptsystem ist der reifste Teil des Oekosystems. Es verbindet PGN-I/O, statische Brettwahrheit, Stockfish-Pipeline, Spielerprofile, Plattformimporte, Training, Agent-CLI und DGT-nahe Workflows.
PTG-Folgehaertung
Review-Ergebnisse sollen Schwierigkeit, Prioritaet und Wiederholungslogik personalisierter Karten beeinflussen.
SearchAdapter
Interne Suche, Kontext und DWZ sollen zuerst ueber CaiLama-Search laufen; Browser-Websuche bleibt Fallback.
Leistungsprofile
Personalisierung braucht Retention, Export, Ambiguitaetsbehandlung und PII-Minimierung.
CaiLama-LLM-Router
Der Router kapselt lokale und entfernte Modellbackends hinter OpenAI-kompatiblen Endpunkten. Er entscheidet nicht ueber Schachfachlogik, sondern ueber Modellzugriff, Aliase, Fallbacks und Betriebsverhalten.
OpenAI-kompatibel
/v1/chat/completions, /v1/models und /health bilden die stabile Konsumoberflaeche.
Rollenmodelle
Aliasgruppen wie chess-small, chess-large, chess-coach, chess-analyst und chess-researcher bedienen CaiLama.
Ausfallverhalten
Round-Robin, Cooldowns, Rate-Limit-Erkennung und exhausted-backend Policies muessen vorhersagbar bleiben.
Privacy-safe
JSONL-Diagnostik soll Latenzen und Backend-Zustaende erfassen, aber keine Prompt-/Response-Inhalte loggen.
CaiLama-Search
CaiLama-Search ist der Such-, DWZ- und RAG-Dienst. Er stellt eine kontrollierte Alternative zu allgemeinem Webscraping bereit und wird zum Wissenskontext fuer Analyse- und Research-Rollen.
Key-Management
MeiliKeyManager muss in Runtime-Pfade, Env-Namen muessen konsistent und Admin-Keys von Search-Keys getrennt sein.
RAG-Vertrag
/v1/context soll Quellen, Snippets und Metadaten nachvollziehbar fuer LLM-Rollen liefern.
Download-basierter Import
Der DWZ-Pfad setzt auf oeffentliche Downloads und Cache-Strategie, nicht auf deaktivierte tokenisierte Schnittstellen.
Semantisches Retrieval
Embedding/Reranking erst mit Eval-Datensatz und Fallback ueber dem bestehenden Meilisearch-Lexikalindex.
CaiLama-Master
Der Master ist Koordination, Webseite und Status. Er bleibt leicht, ignoriert die Unter-Repos und enthaelt keine Runtime-Logik.
cailama.org
Die Website ist die lesbare Master-Doku: Projektstand, Architektur, Roadmap und Betrieb.
Checkskript
scripts/check-ecosystem.sh prueft Unter-Repos, Ignore-Regeln, Pflichtdateien und Web-Deployment.