← all repositories
Narcooo/inkos

AI agent that ghostwrites novels, then audits and revises its own work

It exists to turn a chatbot into a novelist by forcing it through a draft-audit-revise pipeline with human approval gates.

8.2k stars TypeScript AgentsCreative · Design
inkos
Velocity · 7d
+26
★ / day
Trend
accelerating
star history

What it does

InkOS is a TypeScript-based AI agent that manages the full fiction lifecycle—from first draft through self-audit to revision—across genres like fantasy, sci-fi, and urban drama. It wraps that pipeline in a local web Studio, a terminal TUI, and an OpenClaw skill, so you can manage books, chapters, and standalone short stories by typing commands or chatting naturally. A human approval gate sits between each stage, so the agent works alone but cannot ship without your say-so.

The interesting bit

The real engineering is the shared interaction kernel that powers the TUI, Studio, and OpenClaw skill: the same natural-language interpreter handles “tighten the pacing” whether it comes from a chat bubble, a terminal dashboard, or a JSON API payload. It also treats provider compatibility as a first-class concern, with built-in transport detection for MiniMax and automatic parameter stripping for Gemini, which keeps multi-model routing from becoming an endless game of whack-a-mole.

Key highlights

  • Shared interaction runtime across TUI, Studio, and OpenClaw Skill with 15+ natural-language intents (write, revise, rename, export, etc.).
  • Multi-model provider bank with mismatch validation: it will refuse to send a Kimi model to a Gemini endpoint.
  • Human-in-the-loop gating: drafts proceed to audit and revision, but require explicit approval before finalizing.
  • Supports full short-story generation including sales pitch, cover prompt, and cover image output.
  • Studio and CLI configuration are isolated by design, so web UI settings and server env variables do not accidentally overwrite each other.

Caveats

  • The project is updating frequently, so expect shifting features and occasional breaking changes as the pipeline evolves.
  • Multi-model support requires provider-specific workarounds (e.g., MiniMax transport detection, Gemini parameter filtering), so behavior varies slightly across backends.
  • Native English support is available, but the examples, default language, and community focus remain heavily centered on Chinese web fiction.

Verdict

Writers and developers building automated fiction pipelines—especially in the Chinese web-novel ecosystem—should look here. If you just need a one-shot story generator without editorial oversight or multi-chapter book management, this is overkill.

Frequently asked

What is Narcooo/inkos?
It exists to turn a chatbot into a novelist by forcing it through a draft-audit-revise pipeline with human approval gates.
Is inkos open source?
Yes — Narcooo/inkos is open source, released under the AGPL-3.0 license.
What language is inkos written in?
Narcooo/inkos is primarily written in TypeScript.
How popular is inkos?
Narcooo/inkos has 8.2k stars on GitHub and is currently accelerating.
Where can I find inkos?
Narcooo/inkos is on GitHub at https://github.com/Narcooo/inkos.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.