Maximilian Mitterbauer

Fallstudie / RAG-Lab

Synapse

Docker Compose · FastAPI · Qdrant · Ollama · RAG

Überblick

Synapse verbindet technische Markdown-Notizen mit einer lokalen Such- und Frage-Antwort-Pipeline. Die Notizen bleiben als einfache Textdateien lesbar, werden im Wiki sichtbar gemacht und für die semantische Suche indexiert. Fragen an die eigenen Notizen werden mit Bezug zur verwendeten Quelle beantwortet.

Architektur

Synapse hat zwei verbundene Pfade: Die Ingestion macht Notizen auffindbar und lesbar; die Frage-Pipeline holt passenden Kontext und erzeugt daraus eine quellengebundene Antwort.

Pfad

Notizverarbeitung

  1. Eingang

    • Markdown

      Die ursprüngliche Notiz bleibt die lesbare Quelle.

  2. Orchestrierung

    • FastAPI

      Nimmt Notizen an, normalisiert Metadaten und steuert die Pipeline.

  3. Verarbeitung

    • Ollama

      Formatiert optional und erstellt Embeddings für Notizen und Fragen.

  4. Ergebnis

    • Wiki.js

      Macht die aufbereitete Notiz als Knowledge Interface lesbar.

    • Qdrant

      Speichert Chunks, Vektoren und Quellenmetadaten für Retrieval.

Pfad

Fragebeantwortung

  1. Eingang

    • Frage

      Nimmt eine Frage mit optionalem Scope an.

  2. Orchestrierung

    • Embedding

      Ollama bildet die Frage als Vektor ab.

  3. Verarbeitung

    • Qdrant-Retrieval

      Liest ähnliche Chunks aus dem Index.

    • Kontext

      Prüft Scope, Grounding und Quellenbezug.

    • Ollama

      Erhält nur den freigegebenen Kontext.

  4. Ergebnis

    • Antwort + Quellen

      Gibt Antwort und Quellen aus oder lehnt ab.

TUI Demo

Synapse Ask v0.5.0 zeigt eine interaktive TUI für einen lokalen RAG-Workflow.
Synapse Ask v0.5.0: lokale Notizen abfragen und Antworten mit Quellenbezug anzeigen.

Das GIF zeigt Synapse Ask im Terminal: Eine Frage wird gegen lokale, indexierte Notizen gestellt; die Antwort erscheint direkt im Terminal und verweist auf die verwendete Quelle. Die Demo zeigt den aktuellen Kern des Projekts: Markdown-Notizen bleiben als Quellen erhalten und werden praktisch abfragbar.

Architekturentscheidungen

Die drei wichtigsten Entscheidungen (ADRs) dieses Projekts.

Links