Lokale Wissensautomatisierung

Synapse

Synapse ist ein lokales Notiz- und RAG-Lab: Markdown-Notizen werden geordnet, im Wiki sichtbar gemacht und über einen Terminal-Client abfragbar.

  • Docker Compose
  • FastAPI
  • Qdrant
  • Ollama
  • Python
  • RAG

Was das Projekt macht

Synapse verbindet technische Markdown-Notizen mit einer lokalen Such- und Frage-Antwort-Pipeline. Die Notizen bleiben als einfache Textdateien lesbar, werden zusätzlich im Wiki sichtbar gemacht und für die semantische Suche indexiert. Über das Ask-TUI können Fragen gegen die eigenen Notizen gestellt werden; die Antworten zeigen den Bezug zur verwendeten Quelle.

Workflow

  1. 01

    Markdown-Notiz

    Lernnotiz, Lab-Dokumentation oder Runbook als einfache Markdown-Datei.

  2. 02

    Aufbereitung

    Synapse formatiert und bearbeitet die Notiz für Wiki-Anzeige und Indexing.

  3. 03

    Wiki + Index

    Wiki.js macht die Inhalte lesbar, Qdrant macht sie semantisch auffindbar.

  4. 04

    Ask TUI

    Der Terminal-Client fragt das lokale Wissen ab und zeigt Antworten mit Quellenbezug.

Synapse Ask TUI beantwortet eine OSPF-Frage aus indexierten Notizen
Lokale Synapse-Demo: eine terminalbasierte Frage mit Quellenbezug.

Ask / Terminal-Workflow

TUI Demo

Das GIF zeigt Synapse Ask im Terminal: Eine Frage zu OSPF wird gegen indexierte Notizen gestellt, die Antwort erscheint direkt im Terminal und verweist auf die verwendete Quelle. Die Demo zeigt den Kern des Projekts: lokale Notizen werden nicht nur gespeichert, sondern praktisch abfragbar.

Use Cases

Lab-Wissen schnell wiederfinden

Setup-Schritte, Ports, Service-Zusammenhänge, Fehlermeldungen und technische Entscheidungen können aus eigenen Markdown-Notizen abgefragt werden, ohne manuell durch alte Dateien zu suchen.

Technisches Lab-Wissen bleibt auffindbar, ohne ein schweres Dokumentationssystem zu brauchen.

Runbooks im Terminal nutzbar machen

Wiederkehrende Abläufe wie Service-Checks, Troubleshooting-Schritte oder lokale Setup-Prozesse können als einfache Notizen gepflegt und direkt im Terminal abgefragt werden.

Wiederholbare Admin-Abläufe bleiben lokal, schlicht und schnell erreichbar.

Projekt-Dokumentation abfragbar machen

Synapse macht technische Projektnotizen nicht nur lesbar, sondern praktisch nutzbar: Dokumentation bleibt als Markdown einfach, wird aber über Wiki und Suche besser zugänglich.

Projektwissen bleibt als Markdown wartbar und wird trotzdem besser durchsuchbar.

Quellengebundene Antworten statt freies Raten

Antworten sollen sichtbar auf den eigenen indexierten Notizen basieren. Der Quellenbezug macht klar, woher die Antwort kommt.

Der Nutzen liegt im Quellenbezug, nicht in freien Chat-Antworten ohne nachvollziehbare Grundlage.

Was ich gelernt habe

Synapse war vor allem eine Übung darin, Dokumentation praktisch nutzbar zu machen. Notizen sind nur wertvoll, wenn man sie später wiederfindet, einordnet und gegen sie arbeiten kann.

Klarer Ablauf statt Buzzwords

Ein gutes RAG-Projekt wird nicht durch große Begriffe stärker, sondern durch einen nachvollziehbaren Ablauf: Quelle rein, Verarbeitung sichtbar halten, Inhalte auffindbar machen, Antwort mit Referenz ausgeben.

Grenzen bewusst zeigen

Das Projekt ist ein lokales Lab-System, keine produktionsreife Wissensplattform. Dadurch bleibt der Fokus klar: lokale Notizen, nachvollziehbarer Workflow, einfache Bedienung im Terminal.

Aktueller Stand

Der lokale Notiz-, Indexierungs- und Ask-Workflow ist aufgebaut und nachvollziehbar dokumentiert.

Das Projekt ist ein lokales Lab und keine Produktionsumgebung. Funktionen, Modellverhalten und der vollständige Stack sind auf diesen lokalen Anwendungsfall ausgerichtet.