Einführung

Apparat ist eine selbst gehostete, KI-gestützte persönliche Denkwerkstatt. Du sammelst darin, was dir über die Jahre wichtig wird — Notizen, Recherchen, Kontakte, Aufnahmen, Dokumente —, verknüpfst es miteinander und holst später wieder heraus, was du brauchst: eine Auskunft, einen vergessenen Zusammenhang, das Material für einen eigenen Text. Werkstatt heißt dabei, dass darin gearbeitet wird, und zwar von dir: Apparat hält bereit, schlägt vor und gibt Auskunft — entschieden und geschrieben wird von Hand.

Es richtet sich an Menschen, die einen solchen Bestand über Jahrzehnte aufbauen 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 behalten wollen, was ihnen begegnet ist. 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. Und die aus einem über Jahre gewachsenen Bestand irgendwann etwas Neues machen wollen — einen Artikel, einen Vortrag, ein Kapitel.

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.