InkOS: Open-Source-KI-Agent für das Schreiben von Romanen

1. Projektübersicht

InkOS ist ein Open-Source-KI-Agentensystem (AGPL-3.0) für kreatives Schreiben. Es hilft Autorinnen und Autoren, lange Fortsetzungsromane, Kurzgeschichten, Drehbücher, Fan-Fiction und interaktive Welten zu planen, zu entwerfen, zu prüfen und zu überarbeiten – und dabei Figuren, Handlungsstränge und den Zustand der Welt über Hunderte von Kapiteln hinweg konsistent zu halten. Alles wird über einen Arbeitsbereich mit drei Schnittstellen verwaltet: ein Web-Studio, eine Terminal-TUI und eine CLI.

2. Hintergrund & Positionierung

Warum es entwickelt wurde

Die Generierung langer Texte mit einem einzigen Prompt neigt dazu, abzudriften: Figuren verändern sich, Vorausdeutungen werden vergessen und früheren Fakten wird widersprochen. InkOS begegnet diesem Problem, indem das Schreiben auf spezialisierte Agenten aufgeteilt und der Geschichtszustand in einem strukturierten, wiederaufbaubaren Speicher abgelegt wird, statt sich allein auf das Kontextfenster des Modells zu verlassen.

Wie es sich von ähnlichen Projekten unterscheidet

Pipeline statt einzelner Prompt: dedizierte Agenten für Planung, Komposition, Schreiben, Festlegung, Prüfung und Überarbeitung.
Dauerhafter Speicher: kanonischer JSON-Zustand, lesbare Markdown-Projektionen und ein wiederaufbaubarer SQLite-FTS5/BM25-Suchindex.
Atomare Commits: Kapitel, Zustand, Hooks und Snapshots werden gemeinsam committet, sodass ein fehlgeschlagener Lauf kein halb aktualisiertes Buch hinterlässt.
Mehr als Romane: Kurzgeschichten, Drehbücher, Storyboards, interaktive Stücke, Fan-Fiction, Stilimitation und Übersetzung langer Texte teilen sich einen Arbeitsbereich.
Agenten-nativ: enthält 19 integrierte Fähigkeiten im Standardformat SKILL.md und kann von anderen Agenten wie Claude Code und OpenClaw gesteuert werden.

3. Funktionskategorien

✍️ Langformatiges Schreiben

Etwa 6 kooperierende Agenten (Planer, Composer, Schreiber, Festleger, Prüfer, Überarbeiter)
Beispiele: inkos write next, Stapelschreiben mit --count, inkos write rewrite, inkos review, inkos revise
Zweck: Fortsetzungskapitel mit konsistenter Handlung und konsistenten Figuren erzeugen.

🧠 Speicher & Kontrolle

Beispiele: kanonischer JSON-Zustand, Markdown-Projektionen, SQLite-FTS5/BM25-Index, author_intent.md und current_focus.md, Kontextspuren pro Kapitel
Zweck: lange Geschichten kohärent halten und der Autorin bzw. dem Autor die Steuerung der Richtung ermöglichen.

📖 Kurzgeschichten & Cover

Beispiele: inkos short run, inkos short revise, Gliederungen, Prüfprotokolle, Verkaufstexte, Cover-Prompts und optionale Coverbilder
Zweck: vollständige kurze Stücke samt Begleitmaterial erzeugen.

🎮 Interaktives Spiel

Beispiele: Open-World-Modus, verzweigte Geschichten, klickbare Entscheidungen, freie Aktionen, HUD, automatische Illustration
Zweck: eine Geschichtenwelt in ein spielbares Erlebnis verwandeln.

🎨 Stil, Fan-Fiction & Import

Beispiele: inkos style analyze, inkos fanfic init (Canon-, AU-, OOC-, CP-Modi), inkos import chapters, inkos import canon
Zweck: einen Stil imitieren, bestehende Werke erweitern oder mit vorhandenen Kapiteln fortfahren.

🔌 Modelle, Fähigkeiten & Automatisierung

19 integrierte Fähigkeiten; Multi-Modell-Routing pro Agent
Beispiele: OpenAI Chat/Responses, Anthropic Messages, Gemini, DeepSeek, OpenRouter, Ollama und LM Studio; Daemon-Modus (inkos up); Benachrichtigungen über Telegram, Feishu, WeCom und signierte Webhooks
Zweck: InkOS in die eigene Modellkonfiguration und den eigenen Workflow einpassen.

4. Wichtigste Highlights

Multi-Agenten-Schreibpipeline: jede Stufe hat eine einzige Verantwortung, was die Überprüfung und Reparatur der Ausgabe erleichtert.
Wiederaufbaubarer Speicher: der Suchindex kann aus dem kanonischen Zustand neu erzeugt werden, und die Markdown-Projektionen bleiben lesbar und bearbeitbar.
Evidenzbasierte Prüfung: der Prüfer hält Beobachtungen mit Belegen fest; Überarbeitungen erfolgen nur, wenn Sie darum bitten.
Drei Schnittstellen, ein Arbeitsbereich: zwischen Studio, TUI und CLI wechseln, ohne Projekte zu ändern.
Flexible Modellunterstützung: Anbieter mischen und verschiedene Agenten auf unterschiedliche Modelle routen, einschließlich lokaler.
Erweiterbare Fähigkeiten: projekt-, benutzer- und umgebungsspezifische Fähigkeitenverzeichnisse werden unterstützt, und @skill-id erzwingt eine Fähigkeit für einen Zug.

5. Anwendungsfälle nach Rolle

Allgemeine Entwicklerinnen und Entwickler: Buch-Erstellung und -Exporte mit der CLI skripten (--json-Ausgabe ist bei vielen Befehlen verfügbar) oder InkOS über seine Fähigkeiten in Agent-Workflows einbetten.
Autorinnen und Autoren sowie Kreative: Fortsetzungsfiktion, Kurzgeschichten und Fan-Fiction mit konsistentem Weltzustand entwerfen.
Designerinnen und Designer für Spiele und interaktive Medien: verzweigte Erzählungen und Open-World-Szenarien prototypisieren.
DevOps/SRE: den Daemon betreiben (inkos up / inkos down) und Benachrichtigungen über mit HMAC-SHA256 signierte Webhooks empfangen.
Forschende: Multi-Agenten-Langkontext-Generierung und strukturierte Speicherdesigns untersuchen.

6. Erste Schritte

Finden, was Sie brauchen

inkos --help
inkos doctor

Durchsuchen Sie den Ordner docs/ und das Verzeichnis skills/ im Repository.

Installieren und integrieren

Erfordert Node.js 22.16 oder neuer.

npm i -g @actalk/inkos
inkos init my-novel
cd my-novel
inkos

Konfigurieren Sie ein Modell in den Studio-Einstellungen oder über die CLI:

inkos config set-global --provider <provider> --base-url <url> --api-key <key> --model <model>

Typischer CLI-Ablauf:

inkos book create --title "My Novel" --genre xuanhuan
inkos write next "My Novel" --count 5
inkos export "My Novel" --format epub

Zur Verwendung als Fähigkeit in OpenClaw:

clawhub install inkos

Mitwirken

pnpm install
pnpm dev
pnpm test
pnpm typecheck

Lesen Sie CONTRIBUTING.md und eröffnen Sie dann ein Issue oder einen Pull-Request.

7. Projektstruktur

inkos/
├── packages/        # Workspace-Pakete (Core, CLI, Studio)
├── skills/          # Integrierte Fähigkeiten (SKILL.md-Format)
├── docs/            # Dokumentation
├── spec/            # Spezifikationen
├── scripts/         # Wartungsskripte
├── test-project/    # Beispielprojekt zum Testen
├── assets/          # Bilder und statische Ressourcen
├── README.md        # Chinesische README
├── README.en.md     # Englische README
├── CONTRIBUTING.md
├── CHANGELOG.md
└── pnpm-workspace.yaml

8. Verwandtes Ökosystem

pi agent runtime (@mariozechner/pi-ai, @mariozechner/pi-agent-core): das Grundgerüst, auf dem InkOS 2.0 aufbaut.
Studio-Stack: Vite, React und Hono.
Speicherung und Validierung: SQLite FTS5/BM25 und Zod-Schemas.
Modellanbieter: OpenAI-kompatibel, Anthropic, Google Gemini, DeepSeek, OpenRouter, Ollama, LM Studio und weitere.
Agentenplattformen: Claude Code und OpenClaw/ClawHub über die Fähigkeit.

9. Lizenz

InkOS wird unter AGPL-3.0 veröffentlicht.

✅ Die Software nutzen, modifizieren und verbreiten, auch für kommerzielle Zwecke.
✅ Sie privat für eigene Schreibprojekte ausführen.
❌ Modifizierte Versionen verbreiten, ohne den entsprechenden Quellcode unter derselben Lizenz verfügbar zu machen.
ℹ️ Wenn Sie eine modifizierte Version als Netzwerkdienst anbieten, verlangt AGPL-3.0, dass Sie deren Quellcode den Nutzerinnen und Nutzern bereitstellen.
ℹ️ Prüfen Sie LICENSE und ziehen Sie für kommerzielle Integrationen rechtlichen Rat hinzu.

10. FAQ

F: Welche Node.js-Version benötige ich?
A: Node.js 22.16 oder neuer. Installieren Sie die CLI mit npm i -g @actalk/inkos.

F: Funktioniert InkOS auf Englisch?
A: Chinesisch ist die Hauptsprache, Englisch wird mit dem Flag --lang en unterstützt. Siehe README.en.md.

F: Wie überprüfe ich, ob meine Modellkonfiguration funktioniert?
A: Führen Sie inkos doctor aus. Im Studio konfigurierte API-Schlüssel werden in .inkos/secrets.json gespeichert.

F: Kann ich ein Projekt von InkOS 1.x migrieren?
A: Ja. Vorschau mit inkos work migrate --json, dann anwenden mit inkos work migrate --apply.

F: Kann ich lokale Modelle verwenden?
A: Ja. Ollama und LM Studio werden unterstützt, ebenso wie benutzerdefinierte Endpunkte.

11. Schnelllinks

Repository: https://github.com/Narcooo/inkos
Dokumentation: https://github.com/Narcooo/inkos/tree/master/docs
Englische README: https://github.com/Narcooo/inkos/blob/master/README.en.md
Mitwirkungsleitfaden: https://github.com/Narcooo/inkos/blob/master/CONTRIBUTING.md
npm-Paket: https://www.npmjs.com/package/@actalk/inkos
Issues und Diskussionen: https://github.com/Narcooo/inkos/issues

12. Zusammenfassung

InkOS verwandelt KI-gestütztes Schreiben in einen strukturierten, prüfbaren Workflow mit persistentem Geschichtsspeicher, sodass lange Projekte konsistent bleiben. Es eignet sich für Autorinnen und Autoren, Spieldesignerinnen und -designer sowie Entwicklerinnen und Entwickler, die eine kontrollierbare Langformat-Generierung über Romane, Kurzgeschichten und interaktive Welten hinweg wünschen – mit der Freiheit, eigene Modelle und Schnittstellen zu wählen.