InkOS

InkOS is an open-source AI Agent system for story creation and multilingual translation. It provides a complete workbench for long-form novels, short fiction, scripts, storyboards, interactive film/games, fan fiction, open-world play, and long-document translation — all starting from the same unified interface. With over 7,900 GitHub stars, InkOS has a vibrant community of writers and developers.

Developed by Narcooo and selected as a Kimi Open Source Partner, InkOS integrates with multiple AI model providers including OpenAI, Anthropic, Google, DeepSeek, and Kimi. It is licensed under AGPL-3.0 and hosted on GitHub at github.com/Narcooo/inkos.

Via npm (recommended):

npm install -g @actalk/inkos

Quick Start:

inkos                        # Start Studio (web interface)
inkos --mode tui             # Start Terminal User Interface
inkos --mode cli             # Command-line mode

Configure your AI provider via .env file or environment variables. InkOS supports OpenAI, Anthropic, Google, DeepSeek, Kimi, OpenRouter, and any OpenAI-compatible API.

InkOS provides three interfaces that share the same underlying action system:

Interface	Best For
Studio	Web-based visual workbench for managing projects, reviewing chapters, and configuring settings
TUI	Terminal-based interactive interface for focused writing sessions
CLI	Command-line tools for scripting, automation, and batch operations

InkOS supports a wide range of story creation workflows:

• Long-Form Novels — From creative brief to full novel: generate worldbuilding, characters, volume outlines, chapter intents, and prose. Context is organized with protected/compressible layers to maintain steerability across long works.
• Short Fiction — Produce complete standalone stories with full manuscript, outline records, synopsis, selling points, and cover prompts
• Scripts & Storyboards — Author scripts, screenplays, and visual storyboards with scene-by-scene breakdowns
• Fan Fiction & Spinoffs — Style imitation, continuation, and spinoff creation based on existing works
• Interactive Film/Games — Branching story graphs with choices, variables, character relationships, and endings

InkOS includes a complete multilingual translation workbench. Import EPUB, text-based PDF, TXT, or Markdown; choose source and target languages; translate by chapter and semantic segment; maintain a glossary; generate review reports; and export TXT, Markdown, or EPUB. Supported languages include Chinese, English, Japanese, and more.

The translation system supports cross-language creation, meaning you can write original fiction in English natively using --lang en and still access all InkOS features including review, revision, and export.

InkOS Play lets you build open worlds or branching interactive fiction from natural language. Define world contracts, time flow, character agents, inventory, evidence, relationships, scene state, visual rules, guided choices, and free actions with optional image generation.

Interactive film/games support branching scene graphs, variables and flags, character relationship state, multiple endings, node images, and exportable interactive project packages. This makes InkOS a versatile tool for game narrative designers and interactive storytellers.

InkOS features a pluggable skill system that allows professional rules, prompt packs, and context requirements to be injected into the agent's workflow. Skills can be project-specific or global, and can be auto-selected by the agent or forced by the user with @skill-id.

The system also supports traceable web research with research_web, which generates sourced Markdown reports for worldbuilding, historical accuracy, market research, and fact-checking. Research results are reference-only and do not mutate canon or prose without author approval.