f451
f451 in Kürze
f451 verbindet den Komfort eines Wikis mit Git als einziger Quelle. Jede Seite ist eine Markdown-Datei in einem Repository auf Forgejo oder GitHub. Wer lesen und wer freigeben darf, entscheidet das Repository. Jede Änderung geht wie Code als Entwurf durch ein Review, bevor sie veröffentlicht wird.
Features
- Git als Quelle. Ein Space ist ein Repo, eine Seite ein Ordner mit
index.md. Die Datenbank ist nur ein Index und lässt sich jederzeit aus Git neu aufbauen. - Entwurf, Review, Merge. Ein Entwurf ist ein Branch, ein Review ein Pull Request, die Freigabe ein Merge. Konflikte werden angezeigt, nie still überschrieben.
- Rechte vom Git-Provider. Kein eigenes Rollenmodell. Commits entstehen unter dem persönlichen Konto, nie unter einem Service-Account.
- Editor mit zwei Modi. WYSIWYG auf Tiptap und Roh-Markdown, Autosave, lokaler Puffer bei Verbindungsabbruch.
- KI-Agenten über MCP. Agenten lesen, suchen und schreiben Entwürfe über denselben Review-Weg wie Menschen.
- Lesen und Navigieren. Seitenbaum, Volltextsuche auf Deutsch und Englisch, Wissensgraph, Bericht über kaputte Links, Diagramme mit draw.io und Excalidraw.
Tech Stack
| Komponente | Technologie |
|---|---|
| Backend | Node.js, Fastify (TypeScript) |
| Frontend | Next.js |
| Editor | Tiptap/ProseMirror, CodeMirror |
| Index und Suche | PostgreSQL |
| Git-Provider | Forgejo, GitHub |
| Anmeldung | OpenID Connect (Entra ID, Forgejo, andere) |
| Agenten | MCP-Server |
| Test | Vitest, Testcontainers, Playwright |
Live-Demo
Unter f451.rotecodefraktion.de läuft eine öffentliche Instanz, die jede Nacht zurückgesetzt wird. Anmeldung über Forgejo mit demo / da9d33b2efdb41ed (lesen) oder writer / 43dc099d5da028f4 (schreibt zusätzlich im Playground).
Installation
Lokal mit Docker oder Podman, Node 22 und pnpm 9. Die vollständige Anleitung steht im README und im Handbuch auf f451.rotecodefraktion.de.
git clone https://github.com/rotecodefraktion/f451.git
cd f451
Lizenz
Source-available auf Basis der PolyForm Shield License 1.0.0 mit Zusatzbedingungen. Nutzung, Änderung und Weitergabe sind kostenlos, eine Lizenz braucht nur, wer f451 verkauft oder als bezahlten gehosteten Dienst anbietet. Details in der LICENSE.md.