収録件数：458 件のニュース/102 個のAIツール/415 個のオープンソースプロジェクト/75 件の学習リソース
ホームニュースオープンソースモデルAIツールSkills学習リソース
ホーム / オープンソース / inkos

inkos

InkOSは、長編小説、短編小説、二次創作、インタラクティブな世界に対応したオープンソースのAIエージェントシステムで、Webスタジオ、ターミナルUI、CLIから利用できます。

TypeScriptAGPL-3.0Agent
⭐ GitHubhttps://github.com/Narcooo/inkos
10,333
スター数
+0
スター増加率
2026年10月11日
最終更新
0
クリック数

1. プロジェクト概要

InkOSは、創作活動のためのオープンソース（AGPL-3.0）AIエージェントシステムです。著者が長編連載小説、短編小説、脚本、二次創作、インタラクティブな世界の計画、草稿作成、監査、改訂を行うのを支援し、数百章にわたってキャラクター、プロットライン、世界観の一貫性を維持します。すべては、Webスタジオ、ターミナルTUI、CLIの3つのインターフェースを通じて、1つのワークスペースから管理されます。

2. 背景と位置づけ

作成された理由

単一のプロンプトによる長文生成は、ドリフトしがちです。キャラクターが変化したり、伏線が忘れられたり、以前の事実と矛盾したりします。InkOSは、執筆を専門のエージェントに分割し、ストーリーの状態をモデルのコンテキストウィンドウだけに頼るのではなく、構造化された再構築可能なメモリに保存することで、この問題に対処します。

類似プロジェクトとの違い

  • 単一プロンプトではなくパイプライン: 専任のプランナー、コンポーザー、ライター、セトラー、オーディター、リバイザーの各エージェントを備えています。
  • 永続的なメモリ: 正規化されたJSON状態、人間が読めるMarkdownプロジェクション、再構築可能なSQLite FTS5/BM25検索インデックスを備えています。
  • アトミックなコミット: 章、状態、フック、スナップショットが一緒にコミットされるため、失敗した実行でも半分だけ更新された本が残ることはありません。
  • 小説以外にも対応: 短編小説、脚本、ストーリーボード、インタラクティブプレイ、二次創作、スタイル模倣、長文翻訳が1つのワークスペースで共有されます。
  • エージェントネイティブ: 標準のSKILL.md形式で19の組み込みスキルを同梱し、Claude CodeやOpenClawなどの他のエージェントから駆動できます。

3. 機能カテゴリ

✍️ 長編執筆

  • 約6つの連携エージェント（プランナー、コンポーザー、ライター、セトラー、オーディター、リバイザー）
  • 例: inkos write next、--countを使った一括書き込み、inkos write rewrite、inkos review、inkos revise
  • 目的: プロットとキャラクターが一貫した連載章を生成します。

🧠 メモリと制御

  • 例: 正規化されたJSON状態、Markdownプロジェクション、SQLite FTS5/BM25インデックス、author_intent.mdとcurrent_focus.md、章ごとのコンテキストトレース
  • 目的: 長いストーリーの整合性を保ち、著者が方向性を制御できるようにします。

📖 短編小説と表紙

  • 例: inkos short run、inkos short revise、アウトライン、レビュー記録、販売コピー、表紙プロンプト、オプションの表紙画像
  • 目的: 付随資料を含む完全な短編作品を生成します。

🎮 インタラクティブプレイ

  • 例: オープンワールドモード、分岐ストーリー、クリック可能な選択肢、自由形式のアクション、HUD、自動イラスト
  • 目的: ストーリーの世界をプレイ可能な体験に変えます。

🎨 スタイル、二次創作、インポート

  • 例: inkos style analyze、inkos fanfic init（カノン、AU、OOC、CPモード）、inkos import chapters、inkos import canon
  • 目的: スタイルを模倣したり、既存の作品を拡張したり、既存の章から続きを書いたりします。

🔌 モデル、スキル、自動化

  • 19の組み込みスキル、エージェントごとのマルチモデルルーティング
  • 例: OpenAI Chat/Responses、Anthropic Messages、Gemini、DeepSeek、OpenRouter、Ollama、LM Studio、デーモンモード（inkos up）、Telegram、Feishu、WeCom、署名付きWebhookによる通知
  • 目的: InkOSを独自のモデル設定とワークフローに適合させます。

4. 主なハイライト

  • マルチエージェント執筆パイプライン: 各段階が単一の責任を持つため、出力のレビューと修正が容易になります。
  • 再構築可能なメモリ: 検索インデックスは正規化された状態から再生成でき、Markdownプロジェクションは読みやすく編集可能な状態を保ちます。
  • 証拠に基づく監査: オーディターは証拠とともに観察結果を記録し、改訂は要求された場合にのみ行われます。
  • 3つのインターフェース、1つのワークスペース: プロジェクトを変更せずに、スタジオ、TUI、CLIを切り替えられます。
  • 柔軟なモデルサポート: プロバイダーを混在させ、ローカルモデルを含む異なるモデルに異なるエージェントをルーティングできます。
  • 拡張可能なスキル: プロジェクト、ユーザー、環境指定のスキルディレクトリがサポートされ、@skill-idでターンにスキルを強制できます。

5. 役割別のユースケース

  • 一般の開発者: CLIで書籍の作成とエクスポートをスクリプト化したり（多くのコマンドで--json出力が利用可能）、スキルを通じてInkOSをエージェントワークフローに組み込んだりできます。
  • 著者とクリエイター: 一貫した世界観を持つ連載小説、短編小説、二次創作を草稿作成できます。
  • ゲームおよびインタラクティブメディアデザイナー: 分岐するナラティブやオープンワールドのシナリオをプロトタイプできます。
  • DevOps/SRE: デーモン（inkos up / inkos down）を実行し、HMAC-SHA256で署名されたWebhookを通じて通知を受け取れます。
  • 研究者: マルチエージェントの長文コンテキスト生成と構造化メモリ設計を研究できます。

6. はじめに

必要なものを見つける

inkos --help
inkos doctor

リポジトリ内のdocs/フォルダとskills/ディレクトリを参照してください。

インストールと統合

Node.js 22.16以降が必要です。

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

スタジオの設定またはCLIでモデルを設定します:

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

一般的なCLIフロー:

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

OpenClawでスキルとして使用するには:

clawhub install inkos

貢献

pnpm install
pnpm dev
pnpm test
pnpm typecheck

CONTRIBUTING.mdを読み、Issueまたはプルリクエストを開いてください。

7. プロジェクト構造

inkos/
├── packages/        # ワークスペースパッケージ（core、CLI、Studio）
├── skills/          # 組み込みスキル（SKILL.md形式）
├── docs/            # ドキュメント
├── spec/            # 仕様
├── scripts/         # メンテナンススクリプト
├── test-project/    # テスト用サンプルプロジェクト
├── assets/          # 画像と静的アセット
├── README.md        # 中国語README
├── README.en.md     # 英語README
├── CONTRIBUTING.md
├── CHANGELOG.md
└── pnpm-workspace.yaml

8. 関連エコシステム

  • pi agent runtime (@mariozechner/pi-ai、@mariozechner/pi-agent-core): InkOS 2.0が構築されているハーネスです。
  • スタジオスタック: Vite、React、Hono。
  • ストレージと検証: SQLite FTS5/BM25とZodスキーマ。
  • モデルプロバイダー: OpenAI互換、Anthropic、Google Gemini、DeepSeek、OpenRouter、Ollama、LM Studioなど。
  • エージェントプラットフォーム: スキルを通じたClaude CodeとOpenClaw/ClawHub。

9. ライセンス

InkOSはAGPL-3.0でリリースされています。

  • ✅ 商用利用を含め、ソフトウェアの使用、変更、配布が可能です。
  • ✅ 自分の執筆プロジェクトのためにプライベートで実行できます。
  • ❌ 同じライセンスで対応するソースを利用可能にせずに、変更版を配布することはできません。
  • ℹ️ 変更版をネットワークサービスとして提供する場合、AGPL-3.0はユーザーにそのソースを提供することを要求します。
  • ℹ️ LICENSEを確認し、商用統合については法律顧問に相談してください。

10. FAQ

Q: 必要なNode.jsのバージョンは？
A: Node.js 22.16以降です。CLIはnpm i -g @actalk/inkosでインストールします。

Q: InkOSは英語で動作しますか？
A: 中国語が主要言語ですが、--lang enフラグで英語がサポートされています。README.en.mdを参照してください。

Q: モデル設定が機能しているか確認するには？
A: inkos doctorを実行してください。スタジオで設定されたAPIキーは.inkos/secrets.jsonに保存されます。

Q: InkOS 1.xからプロジェクトを移行できますか？
A: はい。inkos work migrate --jsonでプレビューし、inkos work migrate --applyで適用します。

Q: ローカルモデルを使用できますか？
A: はい。OllamaとLM Studioがサポートされており、カスタムエンドポイントも使用できます。

11. クイックリンク

12. まとめ

InkOSは、AI支援による執筆を、永続的なストーリーメモリを備えた構造化された監査可能なワークフローに変え、長いプロジェクトでも一貫性を維持します。小説、短編小説、インタラクティブな世界にわたる制御可能な長文生成を求める著者、ゲームデザイナー、開発者に適しており、独自のモデルとインターフェースを自由に選択できます。