MakiAi commited on
Commit
20b74c6
·
1 Parent(s): 9bf175f

📚 READMEをFrame Bridgeアプリ用に全面更新

Browse files

- プロジェクト概要をAI動画結合アプリに変更
- SSIM技術による高精度フレーム類似度計算の説明追加
- 単体処理・バッチ処理の詳細な使用方法を記載
- 技術的特徴と処理フローの詳細説明を追加

Files changed (1) hide show
  1. README.md +55 -54
README.md CHANGED
@@ -2,9 +2,9 @@
2
  license: mit
3
  title: frame bridge
4
  sdk: gradio
5
- emoji: 🏆
6
- colorFrom: red
7
- colorTo: indigo
8
  thumbnail: >-
9
  https://cdn-uploads.huggingface.co/production/uploads/64e0ef4a4c78e1eba5178d7a/BZfofcX1vEF7kwWQ0i-uB.png
10
  sdk_version: 5.42.0
@@ -14,14 +14,15 @@ sdk_version: 5.42.0
14
 
15
  ![frame-bridge](https://github.com/user-attachments/assets/05977e5b-3e63-4ed2-a5f6-74ada8943994)
16
 
17
- # 📚 Wikipedia to Markdown Converter
18
 
19
- *WikipediaページをMarkdown形式に変換するWebアプリケーション*
20
 
21
  [![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
 
22
  [![Gradio](https://img.shields.io/badge/Gradio-5.42+-FF6B6B?style=for-the-badge&logo=gradio&logoColor=white)](https://gradio.app)
23
  [![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
24
- [![Demo](https://img.shields.io/badge/🚀%20デモサイト-Live-orange?style=for-the-badge)](https://huggingface.co/spaces/MakiAi/wikipedia-to-markdown)
25
 
26
  </div>
27
 
@@ -29,29 +30,29 @@ sdk_version: 5.42.0
29
 
30
  ## 🌟 概要
31
 
32
- **Wikipedia to Markdown Converter** は、Wikipediaの記事を整形されたMarkdownドキュメントに変換するWebアプリケーションです。単体処理と一括処理に対応し、複数のダウンロード形式を提供します。
33
 
34
  ### ✨ **主要機能**
35
 
36
- - 🔄 **単体・一括処理** - 1つまたは複数のWikipediaページを同時変換
37
- - 📊 **詳細分析** - 文字数、成功率、ファイル情報を表示
38
- - 🗜️ **複数形式** - 個別ファイル、結合文書、ZIPダウンロード
39
- - 🌐 **多言語対応** - 全てのWikipedia言語版に対応
40
- - **要使いやすいUI** - 直感的で美しいインターフェース
41
 
42
  ---
43
 
44
  ## 🚀 使い方
45
 
46
- ### **オンラインで試す(推奨)**
47
- **[🚀 デモサイトはこちら](https://huggingface.co/spaces/MakiAi/wikipedia-to-markdown)**
48
 
49
  ### 💻 **ローカルで実行**
50
 
51
  ```bash
52
  # リポジトリをクローン
53
- git clone https://github.com/your-username/wikipedia-to-markdown.git
54
- cd wikipedia-to-markdown
55
 
56
  # 依存関係をインストール
57
  pip install -r requirements.txt
@@ -73,40 +74,34 @@ docker-compose up -d
73
 
74
  ## 📋 操作方法
75
 
76
- ### 🔗 **単体処理**
77
- 1. WikipediaのURLを入力
78
- 2. 「✨ 変換する」ボタンをクリック
79
- 3. 生成されたMarkdownをコピーまたはダウンロード
 
80
 
81
- ### 📚 **一括処理**
82
- 1. 複数のURLを1行に1つずつ入力
83
- 2. 「🚀 一括変換する」ボタンをクリック
84
- 3. 処理結果を確認し、必要な形式でダウンロード
85
-
86
- ### 📊 **処理結果の表示例**
87
  ```
88
- ============================================================
89
- 📊 処理結果サマリー
90
- ============================================================
91
- 🔗 処理対象URL数: 3
92
- 成功: 2
93
- 失敗: 1
94
-
95
- 処理成功: https://ja.wikipedia.org/wiki/Python
96
- 📄 ページタイトル: Python
97
- 📊 文字数: 15,432 文字
98
- 💾 ファイル名: Python.md
99
  ```
100
 
101
  ---
102
 
103
- ## 📦 ダウンロー��形式
104
 
105
- | 形式 | 説明 | 用途 |
106
  |------|------|------|
107
- | **📄 個別ファイル** | 各ページを別々のMarkdownファイル | 個別編集・管理 |
108
- | **📚 結合文書** | 全ページを1つのファイルに結合 | 一括閲覧・印刷 |
109
- | **🗜️ ZIPアーカイブ** | 全ファイルを圧縮してまとめて | 大量ファイルの管理 |
110
 
111
  ---
112
 
@@ -114,25 +109,28 @@ docker-compose up -d
114
 
115
  ### **使用技術**
116
  - **Python 3.8+** - メイン言語
 
 
117
  - **Gradio** - Webインターフェース
118
- - **BeautifulSoup4** - HTML解析
 
119
  - **html2text** - Markdown変換
120
  - **Requests** - HTTP通信
121
 
122
  ### **処理フロー**
123
- 1. **URL検証** - 入力URLの妥当性チェック
124
- 2. **HTML取得** - Wikipediaページの取得
125
- 3. **コンテンツ抽出** - 主要コンテンツの抽出
126
- 4. **クリーンアップ** - 不要部分(脚注、編集リンク等)の削除
127
- 5. **Markdown変換** - 整形されたMarkdownに変換
128
- 6. **ファイル生成** - 各種形式でのファイル出力
129
 
130
  ---
131
 
132
  ## 📁 プロジェクト構成
133
 
134
  ```
135
- wikipedia-to-markdown/
136
  ├── app.py # メインアプリケーション
137
  ├── theme.py # UIテーマ設定
138
  ├── requirements.txt # Python依存関係
@@ -148,8 +146,11 @@ wikipedia-to-markdown/
148
  ### **テーマ変更**
149
  `theme.py`を編集してUIの色やスタイルを変更できます。
150
 
151
- ### **処理ロジック拡張**
152
- `app.py`の`scrape_wikipedia_to_markdown_final()`関数を編集して、変換処理をカスタマイズできます。
 
 
 
153
 
154
  ---
155
 
@@ -161,7 +162,7 @@ wikipedia-to-markdown/
161
 
162
  ## 🤝 コントリビューション
163
 
164
- バグ報告や機能提案は[GitHub Issues](https://github.com/your-username/wikipedia-to-markdown/issues)でお願いします。
165
 
166
  ---
167
 
@@ -169,6 +170,6 @@ wikipedia-to-markdown/
169
 
170
  **🌟 このプロジェクトが役に立ったらスターをお願いします!**
171
 
172
- *© 2025 Wikipedia to Markdown Converter*
173
 
174
  </div>
 
2
  license: mit
3
  title: frame bridge
4
  sdk: gradio
5
+ emoji: 🎬
6
+ colorFrom: purple
7
+ colorTo: blue
8
  thumbnail: >-
9
  https://cdn-uploads.huggingface.co/production/uploads/64e0ef4a4c78e1eba5178d7a/BZfofcX1vEF7kwWQ0i-uB.png
10
  sdk_version: 5.42.0
 
14
 
15
  ![frame-bridge](https://github.com/user-attachments/assets/05977e5b-3e63-4ed2-a5f6-74ada8943994)
16
 
17
+ # 🎬 Frame Bridge
18
 
19
+ *2つの動画を最適なフレームで自動結合するAIアプリケーション*
20
 
21
  [![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
22
+ [![OpenCV](https://img.shields.io/badge/OpenCV-4.8+-5C3EE8?style=for-the-badge&logo=opencv&logoColor=white)](https://opencv.org)
23
  [![Gradio](https://img.shields.io/badge/Gradio-5.42+-FF6B6B?style=for-the-badge&logo=gradio&logoColor=white)](https://gradio.app)
24
  [![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
25
+ [![Demo](https://img.shields.io/badge/🚀%20デモサイト-Live-orange?style=for-the-badge)](https://huggingface.co/spaces/MakiAi/frame-bridge)
26
 
27
  </div>
28
 
 
30
 
31
  ## 🌟 概要
32
 
33
+ **Frame Bridge** は、2つの動画を視覚的に最適なフレームで自動結合するAIアプリケーションです。SSIM(構造的類似性指標)を使用して、動画1の終了部分と動画2の開始部分から最も類似したフレームを検出し、スムーズな動画結合を実現します。
34
 
35
  ### ✨ **主要機能**
36
 
37
+ - 🤖 **AI自動分析** - SSIM技術による高精度フレーム類似度計算
38
+ - 🎯 **最適接続点検出** - 動画間の最も自然な結合点を自動検出
39
+ - 📊 **リアルタイム分析** - 動画情報の即座表示と詳細分析
40
+ - 🎬 **スムーズ結合** - 視覚的に自然な動画結合を実現
41
+ - 🖼️ **接続フレーム表示** - 結合に使用されるフレームの可視化
42
 
43
  ---
44
 
45
  ## 🚀 使い方
46
 
47
+ ### 🌐 **オンラインで試す(推奨)**
48
+ **[🚀 デモサイトはこちら](https://huggingface.co/spaces/MakiAi/frame-bridge)**
49
 
50
  ### 💻 **ローカルで実行**
51
 
52
  ```bash
53
  # リポジトリをクローン
54
+ git clone https://github.com/Sunwood-ai-labsII/frame-bridge.git
55
+ cd frame-bridge
56
 
57
  # 依存関係をインストール
58
  pip install -r requirements.txt
 
74
 
75
  ## 📋 操作方法
76
 
77
+ ### 🎬 **動画結合の手順**
78
+ 1. **動画1(前半)** をアップロード
79
+ 2. **動画2(後半)** をアップロード
80
+ 3. 「🌉 フレームブリッジ実行」ボタンをクリック
81
+ 4. AI分析結果と結合された動画をダウンロード
82
 
83
+ ### 📊 **分析結果の表示例**
 
 
 
 
 
84
  ```
85
+ 🎬 動画結合完了!
86
+
87
+ 📊 分析結果:
88
+ フレーム類似度: 0.847
89
+ 接続品質: 優秀
90
+ 結合情報:
91
+ • 動画1の最適な終了フレームを検出
92
+ 動画2の最適な開始フレームを検出
93
+ スムーズな接続を実現
 
 
94
  ```
95
 
96
  ---
97
 
98
+ ## 🎯 技術的特徴
99
 
100
+ | 技術 | 説明 | 効果 |
101
  |------|------|------|
102
+ | **SSIM分析** | 構造的類似性指標による高精度フレーム比較 | 視覚的に自然な結合点検出 |
103
+ | **自動最適化** | AI による最適接続フレーム自動検出 | 手動編集不要 |
104
+ | **リアルタイム分析** | 動画アップロード時の即座情報表示 | 効率的なワークフロー |
105
 
106
  ---
107
 
 
109
 
110
  ### **使用技術**
111
  - **Python 3.8+** - メイン言語
112
+ - **OpenCV** - 動画処理・フレーム抽出
113
+ - **scikit-image** - SSIM計算
114
  - **Gradio** - Webインターフェース
115
+ - **NumPy** - 数値計算
116
+ - **Pillow** - 画像処理
117
  - **html2text** - Markdown変換
118
  - **Requests** - HTTP通信
119
 
120
  ### **処理フロー**
121
+ 1. **動画アップロード** - 2つの動画ファイルをアップロード
122
+ 2. **フレーム抽出** - 各動画から代表フレームを抽出
123
+ 3. **類似度計算** - SSIM技術による高精度フレーム比較
124
+ 4. **最適点検出** - 最も類似度の高い接続フレームを特定
125
+ 5. **動画結合** - 検出された最適点で動画を結合
126
+ 6. **結果出力** - 結合動画と分析結果を提供
127
 
128
  ---
129
 
130
  ## 📁 プロジェクト構成
131
 
132
  ```
133
+ frame-bridge/
134
  ├── app.py # メインアプリケーション
135
  ├── theme.py # UIテーマ設定
136
  ├── requirements.txt # Python依存関係
 
146
  ### **テーマ変更**
147
  `theme.py`を編集してUIの色やスタイルを変更できます。
148
 
149
+ ### **アルゴリズム調整**
150
+ `app.py`の`find_best_connection_frames()`関数を編集して、フレーム分析ロジックをカスタマイズできます。
151
+
152
+ ### **類似度閾値調整**
153
+ SSIM計算の精度や比較フレーム数を調整して、結合品質を最適化できます。
154
 
155
  ---
156
 
 
162
 
163
  ## 🤝 コントリビューション
164
 
165
+ バグ報告や機能提案は[GitHub Issues](https://github.com/Sunwood-ai-labsII/frame-bridge/issues)でお願いします。
166
 
167
  ---
168
 
 
170
 
171
  **🌟 このプロジェクトが役に立ったらスターをお願いします!**
172
 
173
+ *© 2025 Frame Bridge - AI Video Merger*
174
 
175
  </div>