+
+
-
-
-**MiroFlow** is a **battle-tested** agent framework that reliably completes complex tool-use tasks. We have extensively used it to generate high-quality, post-training agent trace data for **[MiroThinker](https://huggingface.co/collections/miromind-ai/mirothinker-v01-689301b6d0563321862d44a1)**, our suite of open-source agentic models. Some key features are:
-
-- 🌟 **Reproducible SOTA**: **MiroFlow** consistently achieves 72.2% (pass@1 average@3) on GAIA validation set. Follow our [getting-started guide](#get-start) below, or view our many runs of gaia trace on huggingfaces. If you can't reproduce our result, please open a Github issue - We take reproducibility seriously.
-- 🌟 **High Concurrency and Fault Tolerance**: **MiroFlow** scales data collection efficiently and handles rate-limited APIs and unstable network connections with ease.
-- 🌟 **Baked-in observability and evaluation**: **MiroFlow** ships with scripts for benchmarking agents and a straightforward web-ui for visualizing and debugging agent trace data.
-
-# ✨ MiroFlow SOTA Performance
+
-MiroFlow, equipped with Claude Sonnet 3.7 as its primary LLM, **achieved 81.8% pass@3, 82.4% maj. vote, 74.5% pass@1 (best@3), and 72.2% pass@1 (avg@3) on the GAIA validation set**. This represents **state-of-the-art (SOTA) performance** among open-source agent frameworks.
-
-
-> [!NOTE]
-> Our pass@1 scores are reported as both the average across three runs (avg@3) and the best score among those runs (best@3). For most other reported pass@1 results, it is unclear whether they represent an average or a best score across multiple trials (indicated with *).
-
-To prevent agents from retrieving answers directly from Hugging Face, we disabled access to it during the inference and trace collection.
-
-*We have evaluated multiple agent frameworks on GAIA. Please note that some reported results may be overstated or lack clear definitions, and are not reproducible.*
-In contrast, reproducing MiroFlow's results is straightforward with just a few required API keys.
-
-# 🤖 MiroFlow: Modular AI Agent Framework
+- [📰 News & Updates](#-news--updates)
+- [📝 Introduction](#-introduction)
+- [✨ Performance on Benchmarks](#-performance-on-benchmarks)
+- [🚀 Getting Started](#-getting-started)
+- [🌟 MiroThinker](docs/mirothinker.md)
+- [📄 License & Support](#-license--support)
-MiroFlow is a sophisticated, modular framework for building intelligent AI agents with multi-turn conversation capabilities, comprehensive tool integration, and hierarchical sub-agent support.
-
+## 📰 News & Updates
-## Workflow Overview
+- **2025-08-27**: 🎉 **MiroFlow v0.2** - Achieves SOTA performance across [multiple agentic benchmarks](https://miromind.ai/blog/miroflow). Highlights include **HLE 27.2%**, **HLE-Text-Only 29.5%**, **BrowserComp-EN 33.2%**, **BrowserComp-ZH 47.1%**, and **xBench-DeepSearch 72.0%**.
+- **2025-08-26**: 🎉 [GAIA Validation Trace](apps/public-trace/gaia-validation) released (73.94% with pass@1) and [Gradio Demo](https://github.com/MiroMindAI/MiroThinker/tree/main/apps/gradio-demo) released for local deployment.
+- **2025-08-08**: 🎉 **MiroFlow v0.1** - Framework, model, and data are now fully open-sourced!
-MiroFlow handles user queries through a multi-stage and agentic process designed for flexibility and depth. The workflow is organized as follows:
-1. **Intent Recognition & Query Augmentation**
- LLMs analyze user input to detect intent and refine the query.
+## 📝 Introduction
-2. **Planning & Task Orchestration**
- The main agent drafts an execution plan, invokes tools, and coordinates sub-agents.
+**MiroFlow** is a fully open-sourced agent framework designed to reliably complete complex tool-use tasks. Our comprehensive ecosystem includes the following key components:
-3. **Delegation to Sub-Agents**
- Specialized agents (e.g., agent-browsing) handle complex or domain-specific tasks. Sub-agents independently plan, act, and execute tool calls as needed.
+- 🌟 **Reproducible SOTA Performance**: MiroFlow consistently achieves 72.2% (pass@1 average@3) on the GAIA benchmark. Follow our detailed guide to reproduce our released GAIA traces and verify results.
+- 🌟 **Advanced Data Collection**: Our framework features sophisticated data collection capabilities that generate high-quality, post-training agent trace data. We've open-sourced extensive datasets through [MiroVerse](https://huggingface.co/datasets/miromind-ai/MiroVerse-v0.1).
+- 🌟 **Open Source Models**: We provide fully open-sourced models that you can deploy locally and fine-tune for your specific needs. Explore our model collection at [MiroThinker](https://huggingface.co/collections/miromind-ai/mirothinker-v01-689301b6d0563321862d44a1).
+- 🌟 **Comprehensive Training Framework**: We've open-sourced our complete SFT and DPO training recipes, available at [MiroTrain](https://github.com/MiroMindAI/MiroTrain).
+- 🌟 **Reinforcement Learning Framework**: Our RL training exploration and methodologies are fully available through [MiroRL](https://github.com/MiroMindAI/MiroRL).
-4. **Tool Access via MCP Servers**
- When external capabilities are required, agents leverage specialized tools by connecting to MCP (Model Context Protocol) servers.
-5. **Result Synthesis & Output Alignment**
- After task completion, a dedicated summary process synthesizes results, ensuring the output is high-quality and aligned with user instructions (or benchmark formats).
-## Architecture Components
+## ✨ Performance on Benchmarks
-All core components are located in the `MiroFlow/libs/` directory.
+
+
-### Tool Integration 🔧
+MiroFlow **achieved 81.8% pass@3, 82.4% maj. vote, 74.5% pass@1 (best@3), and 72.2% pass@1 (avg@3) on the GAIA validation set**. This represents **state-of-the-art (SOTA) performance** among open-source agent frameworks.
-- **Tool Manager** (`./miroflow-tool/src/miroflow/tool/manager.py`) : Comprehensive MCP server connection manager with tool discovery, persistent connections, and error handling
-
-- **MCP Servers** (`./miroflow-tool/src/miroflow/tool/mcp_servers/`) : Individual tool implementations built on FastMCP. Provides extensive capabilities including:
- - Code execution and analysis (`./python_server.py`)
- - Visual perception (`./vision_mcp_server.py`)
- - Web search and content retrieval (`./searching_mcp_server.py`)
- - Audio transcription (`./audio_mcp_server.py`)
- - Enhanced reasoning capabilities (`./reasoning_mcp_server.py`)
- - Document processing and analysis (`./reading_mcp_server.py`)
+> [!NOTE]
+> Our pass@1 scores are reported as both the average across three runs (avg@3) and the best score among those runs (best@3). For most other reported pass@1 results, it is unclear whether they represent an average or a best score across multiple trials (indicated with *).
-### Agent System 👷
+To prevent agents from retrieving answers directly from Hugging Face, we disabled access to it during the inference and trace collection.
-**Sub-Agents**
-Specialized agents designed for specific domains (e.g., `agent-browsing` for web navigation). Each sub-agent maintains dedicated tool sets and custom prompts, allowing the main agent to delegate tasks requiring specialized expertise. Agent definitions are managed through configuration files with prompts and descriptions customized in `./miroflow/src/miroflow/utils/prompt_utils.py` and `tool_utils.py`.
+*We have evaluated multiple agent frameworks on GAIA. Please note that some reported results may be overstated or lack clear definitions, and are not reproducible.*
+In contrast, reproducing MiroFlow's results is straightforward with just a few required API keys.
-### Support Systems ⚙️
-- **Configuration System** (`./miroflow/src/miroflow/prebuilt/config/`) : Hydra-powered YAML configuration for agents, LLMs, benchmarks, and pricing
+# 🤖 MiroFlow: Modular AI Agent Framework
-- **Output Formatter** (`./miroflow/src/miroflow/utils/io_utils.py`) : Intelligent response formatting that adapts to various benchmark requirements
+MiroFlow is a high-performance, modular framework for building intelligent AI agents that achieve state-of-the-art results on complex benchmarks. It features multi-turn conversation capabilities, comprehensive tool integration, and hierarchical sub-agent support for superior task completion.
-- **Task Logger** (`./miroflow/src/miroflow/logging/`) : Comprehensive logging for agent interactions, tool executions, and performance metrics
+
+WeChat Bot QR Code
-
- WeChat Group QR Code
-
-