t2yeah/brainBuider

Python

0

62 commits

updated Mar 25, 2026

See the code

README

🎧 Sound2Manga - 音から空間と物語を生成するAI

音声データから「空間」「情景」「オノマトペ」「漫画」を生成するAIパイプライン Sound → Space → Scene → Manga


🎬 Demo

Input AudioScene InterpretationManga Output
🎧 環境音(風・鳥)自然環境の情景manga

👉 音からストーリーを生成する体験を提供


💡 概要(Overview)

本プロジェクトは、音声データから以下を段階的に生成するAIシステムです:

  1. 空間認識(都市 / 森林 / 水辺など)
  2. 情景解釈(何が起きているか)
  3. オノマトペ生成(日本語漫画表現)
  4. 漫画画像生成(Animagine XL)

👉 音を「視覚的な物語」に変換する生成AI


🏗 アーキテクチャ(Architecture)

Audio
 ↓
04_features           音響特徴抽出
 ↓
05_audio_events       音イベント検出(PANNs)
 ↓
05_space_similarity   空間類似度(CLAP)
 ↓
06_space_judgement    空間判定
 ↓
07_scene_interpretation 情景解釈
 ↓
08_onomatopoeia       擬音生成(LoRA + LLM)
 ↓
08_manga_prompt       プロンプト生成
 ↓
09_manga_image        画像生成(Animagine XL)
 ↓
10_manga_text         擬音合成
 ↓
11_final_result       最終出力

🚀 主な機能(Features)

  • 🎧 音から空間推定(CLAP + ルール融合)
  • 🧠 LLMによる情景生成
  • 💬 日本語オノマトペ生成(LoRA)
  • 🎨 漫画画像生成(Stable Diffusion XL)
  • 🔁 JSONベースの再現可能パイプライン

🧠 技術スタック(Tech Stack)

Audio

  • PANNs (Cnn14)
  • librosa

Embedding

  • CLAP (laion-clap)

LLM

  • Llama-3 Swallow 8B

Image

  • Animagine XL 4.0

Backend

  • FastAPI

📁 ディレクトリ構成

project/
├── app/services/
├── site/
├── scripts/
├── tests/
├── docs/
├── requirements.txt
├── README.md

⚙️ セットアップ(Reproducibility)

① Clone

git clone https://github.com/t2yeah/brainBuider/
cd brainBuider/project

② 仮想環境

python3 -m venv venv
source venv/bin/activate

③ Install

pip install --upgrade pip
pip install -r requirements.txt

④ モデルダウンロード

LLM

pip install -U "huggingface_hub[cli]"
hf auth login

LoRA(必須)

git clone https://huggingface.co/yadorigi/onomatopoeia-lora models/onoma-lora
export ONOMA_LORA_ADAPTER_DIR=./models/onoma-lora

Imageモデル

from diffusers import StableDiffusionXLPipeline
StableDiffusionXLPipeline.from_pretrained("cagliostrolab/animagine-xl-4.0")

🌐 ngrok の配置

本プロジェクトでは、ローカルの FastAPI / Web サイトを外部公開するために ngrok を使用します。
ngrok バイナリは site/ 直下に配置してください。

配置例

project/
└── site/
    ├── start_web.sh
    ├── stop_web.sh
    ├── status_web.sh
    ├── ngrok
    ├── index.html
    ├── app.js
    ├── assets/
    ├── logs/
    └── runtime/

## ▶ 実行方法(Usage)

### CLI

```bash
python app/services/pipeline.py --audio-id sample

Web起動

./scripts/start_web.sh

API

EndpointDescription
POST /api/upload音声アップロード
GET /analysis/{audio_id}結果取得

🧪 テスト(Tests)

chmod +x tests/run_test.sh
./tests/run_test.sh

👉 sample_audio.wav で再現可能


注意点

1つだけ重要です。
final_result.py は 10_final_result.json に保存する実装ですが、pipeline.py の定義上は 11_final_result.json を期待しているように見えます。ここは不整合がある可能性があります。final_result.py では output_path = result_dir / "10_final_result.json" です。:contentReference[oaicite:1]{index=1}
一方で pipeline.py の step 13 は "11_final_result.json" を出力ファイル名として持っています。:contentReference[oaicite:2]{index=2}

つまり、READMEやテストではどちらかに統一した方がよいです。
実運用上は 10_final_result.json か 11_final_result.json のどちらかに揃える修正 を先に入れるのが望ましいです。


次にやるべきこと

次は tests/expected_output.json も作って、最低限の内容チェックまで入れるのがよいです。

🤖 モデル詳細(Model Details)

Onomatopoeia LoRA

  • Base: Swallow-8B
  • Method: LoRA fine-tuning
  • Data: 約30,000件のオノマトペデータ
  • 用途: 日本語漫画擬音生成

👉 Hugging Face https://huggingface.co/yadorigi/onomatopoeia-lora


学習内容

  • 音イベント(water / wind / footsteps)
  • 空間情報(urban / forest)
  • 文脈情報(mood / intensity)

📊 評価(Evaluation)

  • 人手評価(自然さ)
  • コンテキスト整合性
  • LLM自己検証

⚠️ 制約・注意事項(Limitations)

  • 音の曖昧性により解釈が変わる
  • 空間が "mixed_ambiguous" になる場合あり
  • 音と画像が完全一致しない場合あり
  • GPU必須(24GB推奨)

🔁 再現性(Reproducibility)

  • requirements固定
  • seed固定
  • JSONステップ保存
  • モデルバージョン固定

🚀 今後の改善(Future Work)

  • 空間認識精度向上
  • LoRA改善
  • リアルタイム化
  • UI改善

📜 ライセンス(License)

本プロジェクトは MIT License のもとで公開されています。

Copyright (c) 2026 Yadorigi(ヤドリギ)

本ソフトウェアおよび関連ドキュメントファイルの複製を取得したすべての人に対し、 無償で使用、複製、改変、結合、公開、配布、サブライセンス、および販売を行う権利を許可します。


⚠️ 外部依存(External Dependencies)

本プロジェクトでは、以下の外部モデル・ライブラリを使用しています。
それぞれ独自のライセンスに従って利用してください。

  • LLM(大規模言語モデル)
    • Swallow-8B(Llama系モデル)
  • 画像生成モデル
    • Animagine XL 4.0
  • その他ライブラリ
    • PyTorch / Diffusers / Transformers

📌 注意事項(Notes)

  • 本リポジトリは コードおよびシステム構成のみをMIT Licenseで提供しています。
  • 学習済みモデルやデータセットは本リポジトリには含まれていません。
  • 実際の利用にあたっては、各モデルのライセンス条件に従ってください。
  • 商用利用は、利用するすべてのモデルが許可している場合に限り可能です。

🚀 本プロジェクトについて

本プロジェクトは、チーム Yadorigi(ヤドリギ) によるハッカソン成果物です。

音声データをもとに以下の処理を一貫して実行する生成AIパイプラインを実装しています:

Audio
→ 空間認識(Scene Understanding)
→ プロンプト生成
→ 漫画風画像生成(Manga Image)


💡 免責事項(Disclaimer)

本ソフトウェアは「現状のまま(as is)」で提供されており、 明示または黙示を問わず、いかなる保証も行いません。


✨ 強み(Why This Matters)

  • 音→物語→画像の一貫生成
  • マルチモーダル統合
  • 再現可能な構造設計

🧾 Citation

@misc{sound2manga,
  title={Sound2Manga},
  author={yadorigi team},
  year={2026}
}

🎯 キャッチコピー

音を、物語にする。

t2yeah/brainBuider

Python

0

62 commits

updated Mar 25, 2026

See the code

README

🎧 Sound2Manga - 音から空間と物語を生成するAI

音声データから「空間」「情景」「オノマトペ」「漫画」を生成するAIパイプライン Sound → Space → Scene → Manga


🎬 Demo

Input AudioScene InterpretationManga Output
🎧 環境音(風・鳥)自然環境の情景manga

👉 音からストーリーを生成する体験を提供


💡 概要(Overview)

本プロジェクトは、音声データから以下を段階的に生成するAIシステムです:

  1. 空間認識(都市 / 森林 / 水辺など)
  2. 情景解釈(何が起きているか)
  3. オノマトペ生成(日本語漫画表現)
  4. 漫画画像生成(Animagine XL)

👉 音を「視覚的な物語」に変換する生成AI


🏗 アーキテクチャ(Architecture)

Audio
 ↓
04_features           音響特徴抽出
 ↓
05_audio_events       音イベント検出(PANNs)
 ↓
05_space_similarity   空間類似度(CLAP)
 ↓
06_space_judgement    空間判定
 ↓
07_scene_interpretation 情景解釈
 ↓
08_onomatopoeia       擬音生成(LoRA + LLM)
 ↓
08_manga_prompt       プロンプト生成
 ↓
09_manga_image        画像生成(Animagine XL)
 ↓
10_manga_text         擬音合成
 ↓
11_final_result       最終出力

🚀 主な機能(Features)

  • 🎧 音から空間推定(CLAP + ルール融合)
  • 🧠 LLMによる情景生成
  • 💬 日本語オノマトペ生成(LoRA)
  • 🎨 漫画画像生成(Stable Diffusion XL)
  • 🔁 JSONベースの再現可能パイプライン

🧠 技術スタック(Tech Stack)

Audio

  • PANNs (Cnn14)
  • librosa

Embedding

  • CLAP (laion-clap)

LLM

  • Llama-3 Swallow 8B

Image

  • Animagine XL 4.0

Backend

  • FastAPI

📁 ディレクトリ構成

project/
├── app/services/
├── site/
├── scripts/
├── tests/
├── docs/
├── requirements.txt
├── README.md

⚙️ セットアップ(Reproducibility)

① Clone

git clone https://github.com/t2yeah/brainBuider/
cd brainBuider/project

② 仮想環境

python3 -m venv venv
source venv/bin/activate

③ Install

pip install --upgrade pip
pip install -r requirements.txt

④ モデルダウンロード

LLM

pip install -U "huggingface_hub[cli]"
hf auth login

LoRA(必須)

git clone https://huggingface.co/yadorigi/onomatopoeia-lora models/onoma-lora
export ONOMA_LORA_ADAPTER_DIR=./models/onoma-lora

Imageモデル

from diffusers import StableDiffusionXLPipeline
StableDiffusionXLPipeline.from_pretrained("cagliostrolab/animagine-xl-4.0")

🌐 ngrok の配置

本プロジェクトでは、ローカルの FastAPI / Web サイトを外部公開するために ngrok を使用します。
ngrok バイナリは site/ 直下に配置してください。

配置例

project/
└── site/
    ├── start_web.sh
    ├── stop_web.sh
    ├── status_web.sh
    ├── ngrok
    ├── index.html
    ├── app.js
    ├── assets/
    ├── logs/
    └── runtime/

## ▶ 実行方法(Usage)

### CLI

```bash
python app/services/pipeline.py --audio-id sample

Web起動

./scripts/start_web.sh

API

EndpointDescription
POST /api/upload音声アップロード
GET /analysis/{audio_id}結果取得

🧪 テスト(Tests)

chmod +x tests/run_test.sh
./tests/run_test.sh

👉 sample_audio.wav で再現可能


注意点

1つだけ重要です。
final_result.py は 10_final_result.json に保存する実装ですが、pipeline.py の定義上は 11_final_result.json を期待しているように見えます。ここは不整合がある可能性があります。final_result.py では output_path = result_dir / "10_final_result.json" です。:contentReference[oaicite:1]{index=1}
一方で pipeline.py の step 13 は "11_final_result.json" を出力ファイル名として持っています。:contentReference[oaicite:2]{index=2}

つまり、READMEやテストではどちらかに統一した方がよいです。
実運用上は 10_final_result.json か 11_final_result.json のどちらかに揃える修正 を先に入れるのが望ましいです。


次にやるべきこと

次は tests/expected_output.json も作って、最低限の内容チェックまで入れるのがよいです。

🤖 モデル詳細(Model Details)

Onomatopoeia LoRA

  • Base: Swallow-8B
  • Method: LoRA fine-tuning
  • Data: 約30,000件のオノマトペデータ
  • 用途: 日本語漫画擬音生成

👉 Hugging Face https://huggingface.co/yadorigi/onomatopoeia-lora


学習内容

  • 音イベント(water / wind / footsteps)
  • 空間情報(urban / forest)
  • 文脈情報(mood / intensity)

📊 評価(Evaluation)

  • 人手評価(自然さ)
  • コンテキスト整合性
  • LLM自己検証

⚠️ 制約・注意事項(Limitations)

  • 音の曖昧性により解釈が変わる
  • 空間が "mixed_ambiguous" になる場合あり
  • 音と画像が完全一致しない場合あり
  • GPU必須(24GB推奨)

🔁 再現性(Reproducibility)

  • requirements固定
  • seed固定
  • JSONステップ保存
  • モデルバージョン固定

🚀 今後の改善(Future Work)

  • 空間認識精度向上
  • LoRA改善
  • リアルタイム化
  • UI改善

📜 ライセンス(License)

本プロジェクトは MIT License のもとで公開されています。

Copyright (c) 2026 Yadorigi(ヤドリギ)

本ソフトウェアおよび関連ドキュメントファイルの複製を取得したすべての人に対し、 無償で使用、複製、改変、結合、公開、配布、サブライセンス、および販売を行う権利を許可します。


⚠️ 外部依存(External Dependencies)

本プロジェクトでは、以下の外部モデル・ライブラリを使用しています。
それぞれ独自のライセンスに従って利用してください。

  • LLM(大規模言語モデル)
    • Swallow-8B(Llama系モデル)
  • 画像生成モデル
    • Animagine XL 4.0
  • その他ライブラリ
    • PyTorch / Diffusers / Transformers

📌 注意事項(Notes)

  • 本リポジトリは コードおよびシステム構成のみをMIT Licenseで提供しています。
  • 学習済みモデルやデータセットは本リポジトリには含まれていません。
  • 実際の利用にあたっては、各モデルのライセンス条件に従ってください。
  • 商用利用は、利用するすべてのモデルが許可している場合に限り可能です。

🚀 本プロジェクトについて

本プロジェクトは、チーム Yadorigi(ヤドリギ) によるハッカソン成果物です。

音声データをもとに以下の処理を一貫して実行する生成AIパイプラインを実装しています:

Audio
→ 空間認識(Scene Understanding)
→ プロンプト生成
→ 漫画風画像生成(Manga Image)


💡 免責事項(Disclaimer)

本ソフトウェアは「現状のまま(as is)」で提供されており、 明示または黙示を問わず、いかなる保証も行いません。


✨ 強み(Why This Matters)

  • 音→物語→画像の一貫生成
  • マルチモーダル統合
  • 再現可能な構造設計

🧾 Citation

@misc{sound2manga,
  title={Sound2Manga},
  author={yadorigi team},
  year={2026}
}

🎯 キャッチコピー

音を、物語にする。