|
| 1 | +<div align="center"> |
| 2 | + <img src="docs/mkdocs/docs/assets/miroflow_logo.png" width="100%" alt="MiroFlow" /> |
| 3 | +</div> |
| 4 | + |
| 5 | +<br> |
| 6 | + |
| 7 | +<div align="center"> |
| 8 | + |
| 9 | +[](https://miromindai.github.io/MiroFlow/) |
| 10 | +[](https://dr.miromind.ai/) |
| 11 | +[](https://huggingface.co/collections/miromind-ai/mirothinker-v02-68af084a18035f57b17cd902) |
| 12 | +[](https://huggingface.co/datasets/miromind-ai/MiroVerse-v0.1) |
| 13 | + |
| 14 | +[](https://github.com/MiroMindAI) |
| 15 | +[](https://miromind.ai/) |
| 16 | +[](https://discord.com/invite/GPqEnkzQZd) |
| 17 | +[](https://huggingface.co/datasets/miromind-ai/MiroFlow-Benchmarks/resolve/main/assets/wechat.png) |
| 18 | +[](https://www.xiaohongshu.com/user/profile/5e353bd80000000001000239) |
| 19 | + |
| 20 | +</div> |
| 21 | + |
| 22 | +<div align="center"> |
| 23 | + |
| 24 | +### 🚀 [Try our Demo!](https://dr.miromind.ai/) | 📚 [Full Documentation](https://miromindai.github.io/MiroFlow/)|[English](README.md)|[中文](README_zh.md) |
| 25 | + |
| 26 | +</div> |
| 27 | + |
| 28 | +<table align="center" style="border: 1px solid #ccc; border-radius: 8px; padding: 12px; background-color: #f9f9f9; width: 60%;"> |
| 29 | + <tr> |
| 30 | + <td style="text-align: center; padding: 10px;"> |
| 31 | + <strong>研究アシスタントデモ</strong> - |
| 32 | + <span style="font-size: 0.9em; color: #555;">CVPR 2025最優秀論文を読み、研究アドバイスを提供</span> |
| 33 | + <br> |
| 34 | + <video src="https://github.com/user-attachments/assets/99ed3172-6e9a-467a-9ccb-be45957fe2e4" |
| 35 | + controls muted preload="metadata" |
| 36 | + width="50%" height="50%" |
| 37 | + </video> |
| 38 | + </td> |
| 39 | + </tr> |
| 40 | +</table> |
| 41 | + |
| 42 | +## 📋 目次 |
| 43 | + |
| 44 | +- [📰 ニュース・アップデート](#-ニュースアップデート) |
| 45 | +- [🤖 MiroFlowとは?](#-miroflowとは) |
| 46 | +- [✨ ベンチマーク性能](#-ベンチマーク性能) |
| 47 | +- [🚀 5分で始める](#-5分で始める) |
| 48 | +- [🤖 MiroFlowフレームワーク](#-miroflow-aiエージェント基盤フレームワーク) |
| 49 | +- [🤝 貢献](#-貢献) |
| 50 | +- [❓ よくある質問](#-よくある質問) |
| 51 | +- [📄 ライセンス・サポート](#-ライセンスサポート) |
| 52 | +- [👥 謝辞・貢献者](#-謝辞貢献者) |
| 53 | + |
| 54 | +## 📰 ニュース・アップデート |
| 55 | + |
| 56 | +- **[2025-09-15]**: 🎉🎉 **MiroFlow v0.3** - 強化されたコードベースアーキテクチャと大幅に改善されたベンチマーク性能。MiroFlowが未来予測ベンチマークで1位を獲得。 |
| 57 | +- **[2025-08-27]**: **MiroFlow v0.2** - [複数のエージェントベンチマーク](https://miromind.ai/blog/miroflow)で最先端の性能を達成、HLE (27.2%)、HLE-Text-Only (29.5%)、BrowserComp-EN (33.2%)、BrowserComp-ZH (47.1%)、xBench-DeepSearch (72.0%)を含む |
| 58 | +- **[2025-08-26]**: [GAIA検証トレース](docs/public_trace.md) (73.94% pass@1) とローカルデプロイメント用の[Gradioデモ](https://github.com/MiroMindAI/MiroThinker/tree/main/apps/gradio-demo)をリリース |
| 59 | +- **[2025-08-08]**: 🎉 **MiroFlow v0.1** - フレームワーク、モデル、トレーニングデータの完全なオープンソースリリース |
| 60 | + |
| 61 | +--- |
| 62 | + |
| 63 | +## 🤖 MiroFlowとは? |
| 64 | + |
| 65 | +**MiroFlow**は、複雑な推論タスクで最先端の性能を実現する知的AIエージェントを構築するための包括的なフレームワークです。強化された会話管理、柔軟なツール統合、複数のデータセットにわたる広範囲なベンチマーク評価を提供します。 |
| 66 | + |
| 67 | +**MiroThinker**は、このフレームワーク上に構築されたオープンソースエージェントモデルシリーズです。 |
| 68 | + |
| 69 | +### 🌟 主要ハイライト |
| 70 | + |
| 71 | +- 🏆 **最先端の性能**: [複数のエージェントベンチマーク](https://miromindai.github.io/miroflow-private/v0.3/evaluation_overview/)で1位ランキング |
| 72 | +- 📊 **プレミアムトレーニングデータ**: [MiroVerse](https://huggingface.co/datasets/miromind-ai/MiroVerse-v0.1)による厳選されたデータセット |
| 73 | +- 🤖 **オープンモデル**: [MiroThinker](https://huggingface.co/collections/miromind-ai/mirothinker-v01-689301b6d0563321862d44a1)での完全なコレクション |
| 74 | +- 🔧 **完全なトレーニングスタック**: [MiroTrain](https://github.com/MiroMindAI/MiroTrain)でのSFT/DPOレシピ |
| 75 | +- 🎯 **高度な強化学習**: [MiroRL](https://github.com/MiroMindAI/MiroRL)による強化学習 |
| 76 | + |
| 77 | +### ✨ ベンチマーク性能 |
| 78 | + |
| 79 | +<img width="100%" alt="image" src="docs/mkdocs/docs/assets/futurex-09-12.png" /> |
| 80 | + |
| 81 | +2025年9月10日時点で、FutureXベンチマークリーダーボードで1位を獲得しました。 |
| 82 | + |
| 83 | +<div align="center"> |
| 84 | + <img src="docs/mkdocs/docs/assets/miroflow-0.2-performance_short.png" width="90%" alt="包括的なベンチマーク性能比較" style="border-radius: 8px; box-shadow: 0 4px 8px rgba(3, 3, 3, 0.1);"> |
| 85 | +</div> |
| 86 | + |
| 87 | +**GAIA**、**HLE**、**BrowseComp**、**xBench-DeepSearch**を含む一連のベンチマークでMiroFlowを評価し、最先端の結果を達成しました。 |
| 88 | + |
| 89 | +| モデル/フレームワーク | GAIA Val | HLE | HLE-Text | BrowserComp-EN | BrowserComp-ZH | xBench-DeepSearch | |
| 90 | +|------------------|----------|-----|----------|----------------|----------------|-------------------| |
| 91 | +| **MiroFlow** | **82.4%** | **27.2%** | 29.5% | 33.2% | **47.1%** | **72.0%** | |
| 92 | +| OpenAI Deep Research | 67.4% | 26.6% | - | **51.5%** | 42.9% | - | |
| 93 | +| Gemini Deep Research | - | 26.9% | - | - | - | 50+% | |
| 94 | +| Kimi Researcher | - | - | 26.9% | - | - | 69.0% | |
| 95 | +| WebSailor-72B | 55.4% | - | - | - | 30.1% | 55.0% | |
| 96 | +| Manus | 73.3% | - | - | - | - | - | |
| 97 | +| DeepSeek v3.1 | - | - | **29.8%** | - | - | 71.2% | |
| 98 | + |
| 99 | +# 🚀 5分で始める |
| 100 | + |
| 101 | +リポジトリをクローンし、APIキーを設定して、初めての知的AIエージェントを実行しましょう。必要なのは`OPENROUTER_API_KEY`だけです。 |
| 102 | + |
| 103 | +## 📋 前提条件 |
| 104 | + |
| 105 | +- **Python**: 3.12以上 |
| 106 | +- **パッケージマネージャー**: [`uv`](https://docs.astral.sh/uv/) |
| 107 | +- **オペレーティングシステム**: Linux, macOS |
| 108 | + |
| 109 | +## ⚡ クイックセットアップ |
| 110 | + |
| 111 | +**例**: ファイル処理機能を持つ知的文書解析。 |
| 112 | + |
| 113 | +```bash |
| 114 | +# 1. クローンとセットアップ |
| 115 | +git clone https://github.com/MiroMindAI/MiroFlow && cd MiroFlow |
| 116 | +uv sync |
| 117 | + |
| 118 | +# 2. APIキーの設定 |
| 119 | +cp .env.template .env |
| 120 | +# .envを編集してOPENROUTER_API_KEYを追加 |
| 121 | + |
| 122 | +# 3. 初めてのエージェントを実行 |
| 123 | +uv run main.py trace --config_file_name=agent_quickstart_1 --task="What is the first country listed in the XLSX file that have names starting with Co?" --task_file_name="data/FSI-2023-DOWNLOAD.xlsx" |
| 124 | +``` |
| 125 | + |
| 126 | +🎉 **期待される出力**: エージェントは **\boxed{Congo Democratic Republic}** を返すはずです 😊 |
| 127 | + |
| 128 | +> **💡 ヒント**: 問題が発生した場合は、APIキーが`.env`ファイルで正しく設定されており、すべての依存関係がインストールされていることを確認してください。 |
| 129 | +
|
| 130 | +**🎯 包括的なベンチマークスイート**: |
| 131 | +- **GAIA Validation**: 汎用AIアシスタントのベンチマーク。([論文](https://arxiv.org/abs/2311.12983)) |
| 132 | +- **GAIA-Text-103**: テキストのみのタスクのためのGAIA Validationのサブセット。([論文](https://arxiv.org/abs/2505.22648)) |
| 133 | +- **HLE**: 人類最後の試験。([論文](https://arxiv.org/abs/2501.14249)) |
| 134 | +- **HLE-Text-500**: テキストのみのタスクのためのHLEのサブセット。([論文](https://arxiv.org/pdf/2504.21776)) |
| 135 | + |
| 136 | +詳細なガイドに従って、[ベンチマークドキュメント](https://miromindai.github.io/MiroFlow/v0.3/evaluation_overview/)でベンチマーク結果を再現してください |
| 137 | + |
| 138 | +# 🤖 MiroFlow: AIエージェント基盤フレームワーク |
| 139 | + |
| 140 | +MiroFlowは、複雑な推論タスクで最先端の結果を提供する知的AIエージェントを構築するための高性能でモジュラーなフレームワークです。このフレームワークは、高度なマルチターン会話機能、広範囲なツールエコシステム統合、最適なタスク完了のための階層的サブエージェントオーケストレーションを特徴としています。エージェントの[ワークフローアーキテクチャ](https://miromindai.github.io/MiroFlow/v0.3/core_concepts/)についてもっと学んでください。 |
| 141 | + |
| 142 | +<div align="center"> |
| 143 | +<img src="docs/mkdocs/docs/assets/miroflow_architecture.png" width="100%" alt="MiroFlowアーキテクチャ"> |
| 144 | +</div> |
| 145 | + |
| 146 | +## 🤝 貢献 |
| 147 | + |
| 148 | +コミュニティからの貢献を歓迎します!バグの修正、機能の追加、ドキュメントの改善など、あなたの助けは大変ありがたいです。 |
| 149 | + |
| 150 | +- 📋 **課題**: [GitHub Issues](https://github.com/MiroMindAI/MiroFlow/issues)でバグを報告するか機能をリクエスト |
| 151 | +- 🔀 **プルリクエスト**: プルリクエストで改善を提出 |
| 152 | +- 💬 **ディスカッション**: 質問や議論のために[Discordコミュニティ](https://discord.com/invite/GPqEnkzQZd)に参加 |
| 153 | + |
| 154 | +## ❓ よくある質問 |
| 155 | + |
| 156 | +<details> |
| 157 | +<summary><strong>どのAPIキーが必要ですか?</strong></summary> |
| 158 | +<br> |
| 159 | +開始するのに必要なのはOpenRouter APIキーだけです。OpenRouterは単一のAPIを通じて複数の言語モデルへのアクセスを提供します。 |
| 160 | +</details> |
| 161 | + |
| 162 | +<details> |
| 163 | +<summary><strong>OpenRouter以外の言語モデルを使用できますか?</strong></summary> |
| 164 | +<br> |
| 165 | +はい、MiroFlowは様々な言語モデルをサポートしています。設定の詳細についてはドキュメントを確認してください。 |
| 166 | +</details> |
| 167 | + |
| 168 | +<details> |
| 169 | +<summary><strong>ベンチマーク結果を再現するにはどうすればよいですか?</strong></summary> |
| 170 | +<br> |
| 171 | +ステップバイステップの再現ガイドについては、詳細な<a href="https://miromindai.github.io/MiroFlow/v0.3/evaluation_overview/">ベンチマークドキュメント</a>に従ってください。 |
| 172 | +</details> |
| 173 | + |
| 174 | +<details> |
| 175 | +<summary><strong>商用サポートは利用できますか?</strong></summary> |
| 176 | +<br> |
| 177 | +商用問い合わせとエンタープライズサポートについては、<a href="https://miromind.ai/">ウェブサイト</a>からお問い合わせください。 |
| 178 | +</details> |
| 179 | + |
| 180 | +## 📄 ライセンス・サポート |
| 181 | + |
| 182 | +このプロジェクトはApache License 2.0の下でライセンスされています。 |
| 183 | + |
| 184 | +<div align="center"> |
| 185 | + <img src="https://api.star-history.com/svg?repos=MiroMindAI/MiroFlow&type=Date" alt="Star履歴チャート" height="300"> |
| 186 | +</div> |
| 187 | + |
| 188 | +### 参考文献 |
| 189 | + |
| 190 | +技術レポートは近日公開予定! |
| 191 | + |
| 192 | +``` |
| 193 | +@misc{2025mirothinker, |
| 194 | + title={MiroFlow: An Open-Source Agentic Framework for Deep Research}, |
| 195 | + author={MiroMind AI Team}, |
| 196 | + howpublished={\url{https://github.com/MiroMindAI/MiroFlow}}, |
| 197 | + year={2025} |
| 198 | +} |
| 199 | +``` |
| 200 | + |
| 201 | +## 👥 謝辞・貢献者 |
| 202 | + |
| 203 | +- **ベンチマーク貢献者** 包括的な評価データセットを提供 |
| 204 | +- **オープンソースコミュニティ** これを可能にするツールとライブラリを提供 |
| 205 | + |
| 206 | +MiroFlowをより良くするのに貢献してくれたすべての貢献者に感謝します: |
| 207 | + |
| 208 | +<a href="https://github.com/MiroMindAI/MiroFlow/graphs/contributors"> |
| 209 | + <img src="https://contrib.rocks/image?repo=MiroMindAI/MiroFlow" /> |
| 210 | +</a> |
| 211 | + |
| 212 | +コミュニティに参加して、AIエージェントの未来を構築するのを手伝ってください! |
0 commit comments