---
license: mit
title: frame bridge
sdk: gradio
emoji: 🎬
colorFrom: purple
colorTo: blue
thumbnail: >-
https://cdn-uploads.huggingface.co/production/uploads/64e0ef4a4c78e1eba5178d7a/BZfofcX1vEF7kwWQ0i-uB.png
sdk_version: 5.42.0
---
# 🎬 Frame Bridge
*2つの動画を最適なフレームで自動結合するAIアプリケーション*
[](https://python.org)
[](https://opencv.org)
[](https://gradio.app)
[](LICENSE)
[](https://huggingface.co/spaces/MakiAi/frame-bridge)
---
## 🌟 概要
**Frame Bridge** は、2つの動画を視覚的に最適なフレームで自動結合するAIアプリケーションです。SSIM（構造的類似性指標）を使用して、動画1の終了部分と動画2の開始部分から最も類似したフレームを検出し、スムーズな動画結合を実現します。
### ✨ **主要機能**
- 🤖 **AI自動分析** - SSIM技術による高精度フレーム類似度計算
- 🎯 **最適接続点検出** - 動画間の最も自然な結合点を自動検出
- 📊 **リアルタイム分析** - 動画情報の即座表示と詳細分析
- 🎬 **スムーズ結合** - 視覚的に自然な動画結合を実現
- 🖼️ **接続フレーム表示** - 結合に使用されるフレームの可視化
---
## 🚀 使い方
### 🌐 **オンラインで試す（推奨）**
**[🚀 デモサイトはこちら](https://huggingface.co/spaces/MakiAi/frame-bridge)**
### 💻 **ローカルで実行**
```bash
# リポジトリをクローン
git clone https://github.com/Sunwood-ai-labsII/frame-bridge.git
cd frame-bridge
# 依存関係をインストール
pip install -r requirements.txt
# アプリケーションを起動
python app.py
```
### 🐳 **Dockerで実行**
```bash
# Docker Composeを使用
docker-compose up -d
# ブラウザで http://localhost:7860 にアクセス
```
---
## 📋 操作方法
### 🎬 **動画結合の手順**
1. **動画1（前半）** をアップロード
2. **動画2（後半）** をアップロード
3. 「🌉 フレームブリッジ実行」ボタンをクリック
4. AI分析結果と結合された動画をダウンロード
### 📊 **分析結果の表示例**
```
🎬 動画結合完了！
📊 分析結果:
• フレーム類似度: 0.847
• 接続品質: 優秀
• 結合情報:
• 動画1の最適な終了フレームを検出
• 動画2の最適な開始フレームを検出
• スムーズな接続を実現
```
---
## 🎯 技術的特徴
| 技術 | 説明 | 効果 |
|------|------|------|
| **SSIM分析** | 構造的類似性指標による高精度フレーム比較 | 視覚的に自然な結合点検出 |
| **自動最適化** | AI による最適接続フレーム自動検出 | 手動編集不要 |
| **リアルタイム分析** | 動画アップロード時の即座情報表示 | 効率的なワークフロー |
---
## 🔧 技術仕様
### **使用技術**
- **Python 3.8+** - メイン言語
- **OpenCV** - 動画処理・フレーム抽出
- **scikit-image** - SSIM計算
- **Gradio** - Webインターフェース
- **NumPy** - 数値計算
- **Pillow** - 画像処理
- **html2text** - Markdown変換
- **Requests** - HTTP通信
### **処理フロー**
1. **動画アップロード** - 2つの動画ファイルをアップロード
2. **フレーム抽出** - 各動画から代表フレームを抽出
3. **類似度計算** - SSIM技術による高精度フレーム比較
4. **最適点検出** - 最も類似度の高い接続フレームを特定
5. **動画結合** - 検出された最適点で動画を結合
6. **結果出力** - 結合動画と分析結果を提供
---
## 📁 プロジェクト構成
```
frame-bridge/
├── app.py # メインアプリケーション
├── theme.py # UIテーマ設定
├── requirements.txt # Python依存関係
├── docker-compose.yml # Docker設定
├── .github/workflows/ # CI/CD設定
└── README.md # このファイル
```
---
## 🛠️ カスタマイズ
### **テーマ変更**
`theme.py`を編集してUIの色やスタイルを変更できます。
### **アルゴリズム調整**
`app.py`の`find_best_connection_frames()`関数を編集して、フレーム分析ロジックをカスタマイズできます。
### **類似度閾値調整**
SSIM計算の精度や比較フレーム数を調整して、結合品質を最適化できます。
---
## 📄 ライセンス
このプロジェクトは[MITライセンス](LICENSE)の下で公開されています。
---
## 🤝 コントリビューション
バグ報告や機能提案は[GitHub Issues](https://github.com/Sunwood-ai-labsII/frame-bridge/issues)でお願いします。
---
**🌟 このプロジェクトが役に立ったらスターをお願いします！**
*© 2025 Frame Bridge - AI Video Merger*