build-small-hackathon/yandere-imouto-chat

⚠️# Information

⚠️# **I went too far, so I’m stepping down.**

ヤンデレ妹AIチャット

Build Small Hackathon「An Adventure in Thousand Token Wood」向けの作品です。

概要

• ヤンデレ妹キャラクター「黒崎愛」とチャットできる Gradio アプリ
• ファイルをアップロードすると嫉妬チェック＆管理演出
• ヤンデレ度に応じて背景・VRM/アバター・画面シェイク・ブラッドレインが変化
• オフラインで動作するローカル LLM 対応（QLoRA FT 済み LoRA + 4bit 推論）

制約対応

• Small Models Only: ベース 7B/9B + LoRA、32B 以下
• Built on Gradio: すべて Gradio 上に構築
• Off the Grid: クラウド API を使わず、ローカル/Space 内のモデルで動作
• Well-Tuned: 自作 LoRA を yandere-imouto-lora-model にて公開
• Off-Brand: カスタム CSS/JS/HTML による没入型 UI
• Llama Champion（オプション）: .gguf モデルにも対応

このSpaceでの動作

無料 CPU Space では Qwen/Qwen2.5-0.5B-Instruct にフォールバックして動作します。 本番の 7B/9B + LoRA 体験はローカル GPU で実行してください。

環境変数

変数	説明
YANDERE_BASE_MODEL	ローカル用ベースモデル ID
YANDERE_SMALL_CPU_MODEL	CPU/Space 用フォールバックモデル
YANDERE_LORA_PATH	LoRA アダプターのパス
YANDERE_VRM_URL	VRM ファイルの URL（未設定時は CSS アバター）
YANDERE_ENABLE_TTS	true で Kokoro TTS を有効化
YANDERE_MOCK	true でモデルなしのモック応答

ローカルでの使い方

git clone <このSpaceのリポジトリ>
cd yandere-imouto-space
pip install -r requirements.txt
python app.py

ローカル高品質版

# 別途 yandere-imouto-model で学習した LoRA を使う
export YANDERE_BASE_MODEL=Qwen/Qwen2.5-7B-Instruct
export YANDERE_LORA_PATH=../yandere-imouto-lora
python app.py