Hugging Face's logo

Spaces:
MakiAi
/
frame-bridge
Runtime error

App Files Community
frame-bridge / README.md
MakiAi's picture
MakiAi
📚 READMEをFrame Bridgeアプリ用に全面更新
20b74c6
preview code
|
Raw
History Blame Contribute Delete
5.59 kB

A newer version of the Gradio SDK is available: 6.19.0

Upgrade
metadata 
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

🎬 Frame Bridge

2つの動画を最適なフレームで自動結合するAIアプリケーション

Python OpenCV Gradio License Demo

🌟 概要

Frame Bridge は、2つの動画を視覚的に最適なフレームで自動結合するAIアプリケーションです。SSIM（構造的類似性指標）を使用して、動画1の終了部分と動画2の開始部分から最も類似したフレームを検出し、スムーズな動画結合を実現します。

✨ 主要機能

  • 🤖 AI自動分析 - SSIM技術による高精度フレーム類似度計算
  • 🎯 最適接続点検出 - 動画間の最も自然な結合点を自動検出
  • 📊 リアルタイム分析 - 動画情報の即座表示と詳細分析
  • 🎬 スムーズ結合 - 視覚的に自然な動画結合を実現
  • 🖼️ 接続フレーム表示 - 結合に使用されるフレームの可視化

🚀 使い方

🌐 オンラインで試す（推奨）

🚀 デモサイトはこちら

💻 ローカルで実行 

# リポジトリをクローン
git clone https://github.com/Sunwood-ai-labsII/frame-bridge.git
cd frame-bridge

# 依存関係をインストール
pip install -r requirements.txt

# アプリケーションを起動
python app.py

🐳 Dockerで実行 

# 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ライセンスの下で公開されています。

🤝 コントリビューション

バグ報告や機能提案はGitHub Issuesでお願いします。

🌟 このプロジェクトが役に立ったらスターをお願いします！

© 2025 Frame Bridge - AI Video Merger