Einführung

Apparat ist ein selbst gehostetes, KI-gestütztes System zur Erfassung, Verknüpfung und Exploration persönlichen Wissens. Es richtet sich an Menschen, die ihre Notizen, Recherchen, Kontakte und Ideen über Jahrzehnte sammeln und dabei unabhängig von einem Anbieter bleiben wollen.

Was Apparat anders macht

• Deine Daten bleiben bei dir. Alle Inhalte liegen als gewöhnliche Markdown-Dateien auf deinem Rechner. Kein Cloud-Abo, kein Upload, keine Registrierung. Auch ohne Apparat lesbar, in zehn Jahren immer noch.
• Kein starres Schema. Du legst nicht vorher fest, welche Felder eine Notiz haben darf. Typen wie person, project, concept oder book entstehen beim Benutzen. Apparat hilft dir dabei, konsistent zu bleiben, ohne dich einzusperren.
• KI-Unterstützung nach Maß. Semantische Suche und Dialog sind Zusatz­schichten — das Grundsystem funktioniert ohne sie vollständig. Du entscheidest, ob und in welchem Umfang du die KI nutzt und mit welchen Modellen.
• Verknüpfungen als Standard-Markdown. Links zwischen Notizen sind [Label](./dateiname.md), nicht proprietäre Wikilinks. In jedem anderen Markdown-Editor öffnen sie genauso.

Für wen ist Apparat gedacht?

Für Menschen, die ihr Wissen behalten wollen. Die sich einen Gedanken notieren und sich drei Jahre später wieder daran erinnern. Die beim Recherchieren Querverbindungen zwischen verschiedenen Themen herstellen. Die Fotos, Audio-Aufnahmen, PDFs und eigene Notizen im selben System ablegen, ohne sich für ein Werkzeug zu entscheiden, das in fünf Jahren nicht mehr existiert.

Apparat lässt sich auf verschiedene Weise bedienen. Am bequemsten und für die meisten Aufgaben naheliegend ist die Web-Oberfläche im Browser, in der du Notizen öffnest, schreibst, verknüpfst und durchsuchst. Wer lieber im Terminal arbeitet, erreicht jede Funktion über die Kommandozeile, in der jede Aufgabe (Notizen anlegen, Suchen, Verknüpfen, mit der KI sprechen) ihren apparat <kommando>-Befehl hat. Und weil alle Inhalte gewöhnliche Markdown-Dateien sind, lässt sich dieselbe Sammlung auch mit jedem externen Markdown-Editor bearbeiten. Alle Wege bedienen dieselbe Sammlung; du kannst jederzeit zwischen ihnen wechseln.

Aufbau dieses Handbuchs

• Philosophie — warum Apparat so gebaut ist, wie es gebaut ist. Das ist keine Pflichtlektüre, aber es hilft zu verstehen, warum bestimmte Entscheidungen so und nicht anders ausfallen.
• Erste Schritte — Installation, erste Sammlung anlegen, erste Notiz schreiben.
• Grundbegriffe — Entität, Sammlung, Tags und Typen. Die wenigen Worte, die du brauchst, um den Rest zu verstehen.
• Bedienung in der Web-Oberfläche — der Weg im Browser, vom Anmelden bis zum Chat.
• Bedienung in der Kommandozeile — jedes apparat-Kommando mit Beispielen.
• Ausblick — was noch kommt.

Die technische Spezifikation (Dateinamen-Schema, Frontmatter-Regeln, NanoID-Vergabe, Auflösung Sammlungs-übergreifender Verweise) liegt bewusst in einem separaten Dokument im Quellcode-Repository. Wer Apparat erweitern oder reimplementieren will, findet dort die vollständigen Regeln. Für die reine Nutzung reicht dieses Handbuch.