Skip to content

Narcooo /inkos

Writes long novels, short stories, scripts and storyboards
Script & storyAGPL-3.0Chinese README
Stars
10k
30 days
New
Last push
4 days ago

About inkos

InkOS is an AI agent for long novels, short stories, scripts and storyboards. You work in one place: a web Studio, a terminal UI, or the CLI. It keeps characters, settings and foreshadowing straight across many chapters. The 2.0 dev build has mostly Chinese docs, and API keys cost money.

Best for: Novelists and drama writers who need an agent to keep characters and foreshadowing consistent across a long series.

What it does

  • Writes chapters, short stories, scripts and storyboards from one workbench
  • Ships 19 built-in skills (SKILL.md files) for writing, review, translation and covers
  • Keeps story state in JSON plus a rebuildable SQLite search index
  • Records review notes on continuity, foreshadowing, pacing and emotional arcs
  • Routes different agents, like writer and auditor, to different models
  • Exports a whole book, or EPUB for phones and Kindle

Quickstart

Rewritten from the README. Check the repo for the latest steps.

  1. 1
    Install Node.js 22.16 or newer, then run npm i -g @actalk/inkos
  2. 2
    Create a project with inkos init my-novel, then start Studio with inkos
  3. 3
    In Studio, open model config, pick a provider, paste your API key and test the connection
  4. 4
    Create a book: the command below
    inkos book create --title "吞天魔帝" --genre xuanhuan
  5. 5
    Write and check: inkos write next 吞天魔帝, inkos status, inkos review 吞天魔帝
  6. 6
    Export: inkos export 吞天魔帝 or the command below
    inkos export 吞天魔帝 --format epub

Models and languages

Models it works with

  • Kimi K3
  • DeepSeek V4 Flash
  • DeepSeek V4 Pro
  • GPT Image 2
  • Gemini
  • MiniMax
  • GLM-5.3
  • Doubao
  • Claude
  • Ollama

Interface and docs

  • Chinese
  • English
  • Japanese

Head-to-head

Alternatives

Other script & story projects people compare with inkos.

ExplosiveCoderflome

AI-Novel-Writing-Assistant

Open-source workbench that writes full novels, comic panels and short-drama drafts

Script & story
  • OpenAI
  • DeepSeek
  • xAI
  • +1
3.1k GitHub stars7 days agoAGPL-3.0

lingfengQAQ

webnovel-writer

Claude Code plugin for long Chinese web novels that stay consistent

Script & story
  • Claude
  • ChatGPT
  • Gemini
  • +5
7.3k GitHub starsyesterdayGPL-3.0

zenstory-ai

oh-story-dsh

Open novel, short-drama, game and video-recap workbenches in DeepSeek Harness

Script & story
  • DeepSeek
  • GPT Image 2
  • Seedance
  • +4
431 GitHub stars3 days agoMIT

Drop 13 skills into your coding agent to write Chinese web novels

Script & story
  • GPT Image 2
  • Claude Opus
  • Claude Haiku
7.2k GitHub stars4 days agoMIT

Featured on OpenMicroDrama

Do you maintain inkos? Add this badge to your README so English speakers can find our write-up.

Featured on OpenMicroDrama
markdown
[![Featured on OpenMicroDrama](https://openmicrodrama.com/badges/featured.svg)](https://openmicrodrama.com/projects/narcooo-inkos)

The badge links to this page. Want your description changed? Email support@openmicrodrama.com.

Reviewed Oct 1, 2026. Not affiliated with the model providers it links to; the README carries sponsor and affiliate links. We write these descriptions ourselves. The repo's own docs are the final word.