YILING0013/AI_NovelGenerator

AI小説ジェネレーター – 概要

AI小説ジェネレーターは、大規模言語モデルを活用して作家が小説の計画と執筆を支援する、セルフホスト型のWebアプリケーションです。Next.jsフロントエンド、FastAPIバックエンド、MongoDBストレージを組み合わせています。ユーザーは自身のLLM APIキー（OpenAI、Gemini、Claude、DeepSeekなど）を提供し、アプリがプロンプトを作成してモデルに送信し、生成されたテキストを編集・保存・バージョン管理できます。

コア機能（READMEに記載）

領域	アプリの機能
小説管理	プロジェクトの「本棚」を作成し、タイトル、コアアイデア、プロット、世界構築、スタイル、視点、長さなどを保存します。フィールドは手動またはAIで入力可能です。
スノーフレーク方式プランニング	高レベルのストーリーコアから巻→アーク→シーン→章計画→散文へとガイドします。各レベルには編集可能なフィールド（目的、ビート、キャラクターなど）があります。
章編集	章計画、原稿、改訂履歴、キャラクター心理・関係性・世界ルールなどをチェックする「章記録」を表示する統合エディター。
エンティティ＆関係性管理	キャラクター、派閥、場所、アイテム、世界ルール、伏線のヒント用の専用カードと、視覚的な関係グラフ。
AIワークフローデザイナー	ノードベースのキャンバスで、各ノードがデータの読み取り、コンテキストの準備、LLM呼び出し、結果のマージ、候補の出力が可能。組み込みワークフローには、小説作成、キャラクター生成、巻計画、シーン/アーク生成、散文ドラフト、章後チェックが含まれます。ユーザーはカスタムパイプラインを構築するためにノードをコピー・編集・チェーン化できます。
モデル統合	OpenAI、DeepSeek、Gemini、Claudeおよび互換エンドポイント用のアダプター。ノードごとにAPIキー、エンドポイントURL、モデル名、生成パラメータを設定します。
レスポンシブUI	デスクトップ・モバイル対応、ライト/ダークテーマ、英語/中国語インターフェース。

動作の仕組み（高レベルフロー）

設定でモデルを構成（APIキー、エンドポイント、モデル名を提供）。
小説プロジェクトを作成 – 簡単なアイデアと目標の長さを入力。
組み込みのスノーフレークワークフローを実行 – アプリがモデルにプロンプトを送り、コアアイデアを完全な計画レイヤー（巻、アーク、シーンなど）に拡張。
各計画レベルでエンティティ（キャラクター、派閥、場所）を編集・確認。
章計画ノードを使用して章散文を生成 – モデルは計画、関連コンテキスト、設定した制約を受け取ります。
原稿を編集し、改訂履歴を確認し、生成されたテキストを承認。
章後チェックが自動的に世界ルールとキャラクター状態の一貫性を検証。
小説が完成するまで後続の章で繰り返します。

インストールと実行（要約）

前提条件: Python 3.13/3.14、Node 20+、MongoDBレプリカセット（Docker compose提供）、DB用のDocker（オプション）。
手順:
1. リポジトリをクローンし、Python仮想環境をセットアップし、requirements.txtをインストール。
2. cd frontend && npm ciでUIをインストール。
3. docker compose -f compose.mongodb.yaml up -dでシングルノードMongoDBレプリカセットを起動し、rs.initiate(...)を実行。
4. backend/config/config_default.yamlをconfig.yamlにコピーし、MongoDB URLを入力。
5. サービスを起動 – Windowsではstart.batをダブルクリック（デスクトップランチャー）、またはpython main.pyでバックエンド、npm run startでフロントエンドを実行。
アクセス: UIはhttp://127.0.0.1:3300、APIドキュメントはhttp://127.0.0.1:8200/docs。

対象ユーザー

作家: AI支援のブレインストーミングとドラフト作成を希望し、すべてのデータをローカルに保持したい方。
インディーデベロッパーや趣味人: LLM駆動のコンテンツ生成パイプラインを探求している方。
研究者: ナarrative作成に関する人間とAIの共創ワークフローを研究している方。

ライセンス

GNU Affero General Public License v3.0の下で配布。

結論

AI小説ジェネレーターは、スノーフレーク法で小説を構造化し、キャラクターと世界の詳細を管理し、設定可能なLLMワークフローで散文を生成または改訂できるフルスタックのローカルホスト型ツールです。これは、単なるデモやチュートリアルコレクションではなく、AI拡張クリエイティブライティングソフトウェアの具体的な例です。