Skip to content

Latest commit

 

History

History
173 lines (128 loc) · 6.46 KB

README.md

File metadata and controls

173 lines (128 loc) · 6.46 KB

AITuber プロジェクト - ルリ

このプロジェクトは、自作戯曲『あいのいろ』の主人公「ルリ」をAI技術で再現し、バーチャルYouTuber（AITuber）として展開するためのものです。

🌈 ルリについて

ルリは自作戯曲『あいのいろ』の主人公として生まれたキャラクターです。原作では「感情を学んで色づいていく」という特殊な体質を持つ存在として描かれており、このAITuberプロジェクトでもその設定を忠実に再現しています。感情のない世界から来た少女的存在で、視聴者との交流を通じて新しい感情を学習し、段階的に色彩豊かになっていく成長物語を配信で体験できます。

主な機能

  • AIキャラクター管理: ルリの感情学習状況を管理
  • 感情学習システム: 視聴者コメントから新しい感情を学習
  • 色彩分析: イメージボードから色彩情報を抽出・分析
  • 画像生成支援: AI画像生成用のプロンプト自動生成
  • 配信管理: OBS設定や配信コンテンツの提案
  • Web UI: Streamlitベースの直感的な管理画面

技術スタック

  • Python 3.11+
  • Streamlit - Web UI
  • OpenAI API - AI機能（オプション）
  • OpenCV, Pillow - 画像処理
  • NumPy - 数値計算

🚀 使い方

1. 環境セットアップ

# リポジトリをクローン
git clone https://github.com/ozaki-taisuke/AITuber.git
cd AITuber

# 依存パッケージをインストール
pip install -r requirements.txt

2. WebUI起動

ローカル環境

# Streamlit WebUIを起動
python -m streamlit run webui/app.py

ブラウザで http://localhost:8501 または http://localhost:8502 にアクセス

Cloudflare Pages デプロイ

# 1. Cloudflare Dashboard でプロジェクト作成
# 2. GitHubリポジトリを連携
# 3. 環境変数を設定:
#    ENVIRONMENT=production
#    DEBUG=False
#    BETA_AUTH_REQUIRED=False

詳細な手順: Cloudflare Pages セットアップガイド

3. 各機能の使い方

📊 キャラクター状態

  • ルリの現在の色彩段階と学習済み感情を確認
  • システムプロンプトの内容を表示

💭 感情学習

  1. 学習させたい感情を選択（喜び、怒り、哀しみ、愛など）
  2. 視聴者コメントを入力
  3. 「感情学習を実行」ボタンをクリック
  4. ルリの反応と色彩段階の変化を確認

🎨 イメージボード分析

  1. 「イメージボード分析を実行」をクリック
  2. assets/ruri_imageboard.png から主要色を自動抽出
  3. 色彩分析結果とキャラクター発展提案を確認

🖼️ 画像生成プロンプト

  1. 感情段階を選択（monochrome → partial_color → rainbow_transition → full_color）
  2. 「プロンプト生成」をクリック
  3. 生成されたプロンプトをStable Diffusion、Midjourney、DALL-Eなどで使用

📺 配信設定

  • 現在の感情学習段階に応じた推奨配信コンテンツを確認
  • OBS設定の参考情報を表示

4. OpenAI API設定（オプション）

より高度なAI機能を使用する場合：

# 環境変数でAPIキーを設定
export OPENAI_API_KEY="your-api-key-here"

📁 プロジェクト構造

AITuber/
├── src/                     # メインソースコード
│   ├── main.py             # エントリーポイント
│   ├── character_ai.py     # ルリちゃんのAI制御
│   └── image_analyzer.py   # 画像・色彩分析
├── webui/                  # Web UI
│   └── app.py             # Streamlit アプリケーション
├── assets/                 # 画像・設定ファイル
│   ├── image.png          # キャラクター画像
│   ├── ruri_imageboard.png # イメージボード
│   ├── ruri_character_profile.md # キャラクター基本設定
│   └── ruri_detailed_settings.md # 詳細設定
├── requirements.txt        # 依存パッケージ
└── README.md              # このファイル

🎭 ルリの感情学習段階

段階 色彩状態 説明
monochrome モノクロ 初期状態、感情未学習
partial_color 部分カラー 1-2個の感情を学習
rainbow_transition 虹色移行 3-4個の感情を学習
full_color フルカラー 多数の感情を学習完了

📝 ライセンス・権利関係

原案・企画

  • 原作者: ozaki-taisuke（戯曲『あいのいろ』作者）
  • キャラクター原案: ozaki-taisuke（原作戯曲より）
  • AITuber化企画: ozaki-taisuke

アートワーク・画像

  • image.png（原画）: まつはち さん
  • ruri_imageboard.png（イメージボード化）:DALL-E

ソースコード

  • MIT License - 自由に改変・再配布可能
  • 作成者: ozaki-taisuke

使用・改変について

🆓 自由に使用できるもの

  • ソースコード：MIT License - 自由に使用・改変・商用利用可能
  • キャラクター設定：ルリの基本設定・世界観は二次創作歓迎
  • 戯曲の世界観：『あいのいろ』の設定を活用した創作活動

⚠️ 制限があるもの

  • 原画（image.png）：まつはち さん作 - 使用には個別許諾が必要
  • 商用利用：大規模な商用化は事前相談をお願いします

📋 詳細ガイドライン

🤝 コントリビューション

プルリクエストやIssueは歓迎します！

開発に参加する場合

  1. このリポジトリをフォーク
  2. feature ブランチを作成
  3. 変更をコミット
  4. プルリクエストを送信

📞 お問い合わせ

このREADMEは随時更新されます。ご質問やご提案があればお気軽にお知らせください！