TSF Closet

🌐 日本語 | English

TSF Closet

TSF Closet は nata-water/wakuwaku-transform-magic を fork し、TSF (性転換) テーマに特化させたインタラクティブ着せ替えゲームです。

キャラクター画像に対して自然言語で衣装変更を指示すると、AI が画像を変換し、キャラクターの心理変化をリアルタイムに描写します。パラメータの変動、臨界点イベントなど、ビジュアルノベル風のゲームシステムを搭載しています。

スクリーンショット

ゲームプレイ

初期画面	着せ替え後

プレイ要約 & 称号

称号生成前	称号生成後	共有用プレビュー

インペイント (部分変更)

マスク編集	生成中	結果

ギャラリー

セッション一覧	画像一覧

初回セットアップ (NovelAI)

APIキー同意	サブスクリプション警告

主な機能

機能	説明
キャラクター選択	プリセットキャラクター or カスタム画像アップロード
着せ替え実行	自然言語で衣装変更を指示 (例:「バニーレオタードに着替えて」)
AI 画像生成	ComfyUI / OpenRouter / NovelAI の 3 プロバイダーを切り替え可能
心境セリフ生成	Vision LLM + Text LLM でキャラクターの反応をストリーミング表示
パラメータシステム	開花度・羞恥心・順応度が衣装に応じて変動
臨界点イベント	開花度が閾値に達すると特別な演出セリフが発火
実績システム	12 種類の実績を自動判定
ギャラリー	過去の変身画像・達成エンディングを閲覧
プレイ要約 & 称号	LLM がプレイ履歴から要約と称号 (二つ名) を自動生成
共有プレビュー	要約カードを OGP 風画像 (1200×630) で保存・クリップボードコピー
インペイント / マスク	部分的な衣装変更に対応 (システム / 履歴 / プリセットマスク)
キャラクター会話	着せ替え以外にもキャラクターとチャット可能
多言語対応	日本語 / English 切り替え (会話言語バリデーション付き)

アーキテクチャ

┌────────────────────┐
│  Browser (React)   │
│  :3000 (dev)       │
└────────┬───────────┘
         │ /api/*
         ▼
┌────────────────────┐     ┌──────────────────────────────────┐
│  FastAPI Backend   │────▶│  Image Generation                │
│  :8000             │     │  ├ ComfyUI (selfhost, GPU)       │
│                    │     │  ├ OpenRouter API (cloud)         │
│  ├ Game Router     │     │  └ NovelAI Image API             │
│  ├ Gallery Router  │     └──────────────────────────────────┘
│  ├ Achievements    │     ┌──────────────────────────────────┐
│  ├ Settings Router │────▶│  LLM / Vision                   │
│  └ Health          │     │  ├ LiteLLM → Ollama (selfhost)  │
└────────────────────┘     │  ├ OpenRouter Vision / LLM      │
                           │  └ NovelAI Text API              │
                           └──────────────────────────────────┘

技術スタック

レイヤー	技術
フロントエンド	React 19 + TypeScript + Vite
バックエンド	FastAPI + Python 3.12
データベース	SQLite (aiosqlite + SQLAlchemy + Alembic)
画像生成	ComfyUI (Qwen Image Edit) / OpenRouter / NovelAI
テキスト生成	LiteLLM Proxy → Ollama / OpenRouter / NovelAI Text
国際化	i18next (ja / en)
コンテナ	Docker Compose (6 サービス)

クイックスタート

前提条件

Python 3.12+
Node.js 20+
uv (Python パッケージマネージャー)
画像生成プロバイダー (いずれか 1 つ):
- ComfyUI + NVIDIA GPU (セルフホスト)
- OpenRouter API キー
- NovelAI API キー (Opus 推奨)

1. セットアップ

# バックエンド依存パッケージ
cd backend
uv sync

# フロントエンド依存パッケージ
cd ../frontend
npm install

2. 環境変数の設定

.env.example をコピーして .env を作成し、利用するプロバイダーに応じて設定します:

Copy-Item .env.example .env

3. アプリケーション起動

# バックエンド (ポート 8000)
cd backend
uv run uvicorn gateway.app:app --host 0.0.0.0 --port 8000 --reload

# フロントエンド (ポート 3000) ※別ターミナル
cd frontend
npm run dev

ブラウザで http://localhost:3000/ にアクセスしてください。

Docker デプロイ

docker compose up -d
# バックエンドのデータベースマイグレーション適用
docker compose exec backend bash -c "uv run alembic upgrade head"

注意: ComfyUI のモデルダウンロード完了まで 1 時間以上かかる場合があります。docker compose logs -f comfyui で進行状況を確認してください。

サービス	説明	ポート
`frontend`	React + nginx	80
`backend`	FastAPI	(内部)
`litellm`	LiteLLM Proxy	4000
`litellm_db`	PostgreSQL 16	5432
`ollama`	ローカル LLM (GPU)	—
`comfyui`	画像生成 (GPU)	8188

システム要件 (Docker):

NVIDIA GPU (ollama, comfyui)
ストレージ: 100 GB 以上の空き容量
メモリ: 64 GB 以上推奨

ポータブル版ビルド

GPU 環境がないユーザー向けに、Windows ポータブル配布パッケージを作成できます:

.\scripts\build_portable.ps1 -Version "0.1.0" -Provider novelai

パラメータ	説明	デフォルト
`-Version`	バージョン文字列	`dev`
`-Provider`	`novelai` / `selfhost` / `openrouter`	`novelai`
`-Force`	既存出力を上書き	—
`-NoZip`	ZIP 作成をスキップ	—
`-SkipFrontend`	フロントエンドビルドをスキップ	—
`-SkipPython`	Python 環境構築をスキップ	—

出力先: dist/tsf_closet_portable_v{Version}_{Provider}/

画像生成プロバイダー

環境変数 IMAGE_PROVIDER で切り替え:

プロバイダー	環境変数例	必要なもの
`selfhost`	`COMFYUI_BASE_URL=http://127.0.0.1:8188`	NVIDIA GPU + ComfyUI
`openrouter`	`OPENROUTER_API_KEY=sk-...`	OpenRouter API キー
`novelai`	`NOVELAI_API_KEY=pst-...`	NovelAI API キー (Opus 推奨)

テキスト生成 (心境セリフ) も同様に FEELING_PROVIDER で切り替え可能です。

OpenRouter 利用時の注意

R18 / NSFW モードの画像生成・画像編集には対応していません (対応モデルが現時点で見つかっていないため)。

内部で nano banana を利用しているため、「バニーガール」など一部のプロンプトがコンテンツフィルターに抵触し、画像生成エラーになる場合があります。

ゲームシステム

パラメータ

パラメータ	範囲	説明
開花度 (bloom)	0 〜 100	女性化への順応度。衣装の露出度・カテゴリで増加
羞恥心 (shame)	0 〜 100	露出度の高い衣装で上昇。開花速度に影響
順応度 (adaptation)	-50 〜 +50	正は積極的、負は抵抗的な心理状態

難易度

難易度	羞恥心初期値	開花倍率	順応倍率
easy (抵抗しやすい)	70	0.5x	1.0x
normal (普通)	50	1.0x	1.0x
hard (堕ちやすい)	30	1.5x	1.2x

臨界点イベント

開花度が閾値に達すると、キャラクターが特別な演出セリフを発します:

閾値	内容
25%	女性化への違和感を自覚
50%	抵抗と快楽の狭間で揺れる
75%	女性としての感覚を受け入れ始める
100%	完全に女性として順応

エンディング (4 種類)

エンディング	条件概要
快楽開花エンド	開花度 100 + 露出系変身が最多
自己受容エンド	開花度 100 + 可愛い系変身が最多
抵抗の限界エンド	変身 15 回 + 開花度 50 未満
好奇心の暴走エンド	開花度 100 + タグ分散

実績システム (12 種類)

変身回数、女装回数、コレクション数、開花度などの条件に応じて自動的にアンロックされます。

API エンドポイント

Game (`/api/game`)

メソッド	パス	説明
`POST`	`/start`	ゲームセッション開始
`POST`	`/start-custom`	カスタム画像でセッション開始
`POST`	`/play/stream`	着せ替え実行 (SSE ストリーミング)
`GET`	`/characters`	キャラクター一覧取得
`GET`	`/session`	アクティブセッション取得
`GET`	`/sessions`	セッション一覧 (ページネーション)
`DELETE`	`/session`	セッションリセット
`POST`	`/chat`	キャラクターとの会話
`GET`	`/endings`	エンディング一覧
`GET`	`/masks`	マスク一覧取得

Gallery (`/api/gallery`)

メソッド	パス	説明
`GET`	`/`	ギャラリーアイテム一覧
`GET`	`/sessions`	セッション別ギャラリー
`GET`	`/{item_id}`	アイテム詳細 (前後ナビ付き)
`DELETE`	`/{item_id}`	アイテム削除
`GET`	`/sessions/{session_id}/summary`	プレイ要約・称号の取得
`POST`	`/sessions/{session_id}/summary`	プレイ要約・称号の生成 (`?language=`)

Achievements (`/api/achievements`)

メソッド	パス	説明
`GET`	`/`	実績一覧取得
`GET`	`/{achievement_id}`	実績詳細取得

Settings (`/api/settings`)

メソッド	パス	説明
`GET`	`/`	セッション設定取得
`PUT`	`/`	セッション設定更新
`GET`	`/user`	ユーザー設定取得
`PUT`	`/user`	ユーザー設定更新

SSE イベント (`/api/game/play/stream`)

イベント	データ
`feeling`	キャラクターの心境セリフ (チャンク形式)
`image`	生成画像の Base64 データ
`tags`	衣装タグ情報 (カテゴリ・露出度)
`stats`	パラメータ変動値
`critical`	臨界点到達時の演出セリフ
`ending`	エンディング判定結果
`achievement`	実績アンロック通知
`done`	処理完了

環境変数一覧

クリックで展開

共通

変数名	説明	デフォルト
`PORT`	サーバーポート	`8000`
`LOG_LEVEL`	ログレベル	`info`
`IMAGE_PROVIDER`	画像生成プロバイダー (`selfhost` / `openrouter` / `novelai`)	`selfhost`
`IMAGE_DESCRIPTION_PROVIDER`	画像説明プロバイダー	`selfhost`
`FEELING_PROVIDER`	心境生成プロバイダー	`selfhost`

ComfyUI (selfhost)

変数名	デフォルト
`COMFYUI_BASE_URL`	`http://127.0.0.1:8188`
`COMFYUI_WORKFLOW_PATH`	`workflows/qwen_image_edit_template.json`
`COMFYUI_REQUEST_TIMEOUT`	`180`

LiteLLM (selfhost)

変数名	デフォルト
`LITELLM_BASE_URL`	`http://127.0.0.1:4000`
`LITELLM_LLAVA_MODEL`	`ollama/ministral-3:3b-instruct-2512-q4_K_M`
`LITELLM_LLM_MODEL`	`ollama/ministral-3:3b-instruct-2512-q4_K_M`
`LITELLM_FEELING_MODEL`	`ollama/ministral-3:3b-instruct-2512-q4_K_M`

OpenRouter

変数名	デフォルト
`OPENROUTER_API_KEY`	(必須)
`OPENROUTER_IMAGE_MODEL`	`google/gemini-2.5-flash-image`
`OPENROUTER_VISION_MODEL`	`mistralai/ministral-14b-2512`
`OPENROUTER_LLM_MODEL`	`x-ai/grok-4.1-fast`

NovelAI

変数名	デフォルト
`NOVELAI_API_KEY`	(必須)
`NOVELAI_MODEL`	`nai-diffusion-4-5-full`
`NOVELAI_INPAINT_MODEL`	`nai-diffusion-4-5-full-inpainting`
`NOVELAI_STEPS`	`28`
`NOVELAI_SCALE`	`5.0`
`NOVELAI_I2I_STRENGTH`	`0.9`
`NOVELAI_TEXT_MODEL`	`glm-4-6`

データ永続化

変数名	デフォルト
`DATABASE_PATH`	`data/database.sqlite`
`HISTORY_IMAGES_DIR`	`data/history_images`
`HISTORY_MAX_COUNT`	`50`
`CHARACTERS_DIR`	`images/characters`

キャラクターの追加

backend/images/characters/characters.json を編集し、同ディレクトリに画像を配置します:

{
  "characters": [
    {
      "id": "char1",
      "name": "主人公",
      "description": "普通の男子高校生",
      "image_path": "char1.png",
      "pronoun": "僕",
      "personality": "内気で真面目"
    }
  ]
}

カスタム画像はゲーム開始時に UI からアップロードすることも可能です。

フロントエンド画面

パス	画面
`/` `/play`	メインゲーム画面
`/gallery`	ギャラリー
`/achievements`	実績一覧
`/endings`	エンディング一覧
`/settings`	設定

開発

# バックエンド (ホットリロード)
cd backend
uv run alembic upgrade head
uv run uvicorn gateway.app:app --host 0.0.0.0 --port 8000 --reload

# フロントエンド (Vite dev server)
cd frontend
npm run dev

# Lint
cd frontend; npm run lint
cd backend; uv run ruff check .

# テスト
cd frontend; npm run e2e:test
cd backend; uv run pytest

マイグレーション

cd backend
uv run alembic revision --autogenerate -m "migration_comment"
uv run alembic upgrade head

fork 元との差分

本プロジェクトは nata-waterさんが開発されたwakuwaku-transform-magic (子供向け変身ごっこアプリ) を fork し、以下の変更を加えています:

TSF (性転換) テーマへの全面的な書き換え
パラメータシステムの再設計 (ワクワク度 → 開花度 / 羞恥心 / 順応度)
エンディング条件の再設計
NovelAI プロバイダーの追加
インペイント / マスク機能の追加
実績システムの追加
ギャラリー機能の拡張
会話 (チャット) 機能の追加
多言語対応 (i18next)
ポータブル版ビルドスクリプト
画質改善機能

Name		Name	Last commit message	Last commit date
Latest commit History 51 Commits
.github		.github
.specify		.specify
.vscode		.vscode
backend		backend
docker		docker
frontend		frontend
repo_resources		repo_resources
scripts		scripts
.dockerignore		.dockerignore
.env.docker		.env.docker
.env.example		.env.example
.env.example.novelai		.env.example.novelai
.env.example.openrouter		.env.example.openrouter
.env.example.selfhost		.env.example.selfhost
.gitattributes		.gitattributes
.gitignore		.gitignore
AGENTS.md		AGENTS.md
License.txt		License.txt
README.md		README.md
README_en.md		README_en.md
compose.yaml		compose.yaml

Folders and files

Latest commit

History

Repository files navigation

TSF Closet

スクリーンショット

ゲームプレイ

プレイ要約 & 称号

インペイント (部分変更)

ギャラリー

初回セットアップ (NovelAI)

主な機能

アーキテクチャ

技術スタック

クイックスタート

前提条件

1. セットアップ

2. 環境変数の設定

3. アプリケーション起動

Docker デプロイ

ポータブル版ビルド

画像生成プロバイダー

ゲームシステム

パラメータ

難易度

臨界点イベント

エンディング (4 種類)

実績システム (12 種類)

API エンドポイント

Game (/api/game)

Gallery (/api/gallery)

Achievements (/api/achievements)

Settings (/api/settings)

SSE イベント (/api/game/play/stream)

環境変数一覧

共通

ComfyUI (selfhost)

LiteLLM (selfhost)

OpenRouter

NovelAI

データ永続化

キャラクターの追加

フロントエンド画面

開発

マイグレーション

fork 元との差分

ライセンス

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 3

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Game (`/api/game`)

Gallery (`/api/gallery`)

Achievements (`/api/achievements`)

Settings (`/api/settings`)

SSE イベント (`/api/game/play/stream`)

Packages