高性能迭代推理 Agent 框架，通过 CodeAgent 执行模式与 Tool Search Tool 动态工具发现实现高效的任意查询处理。
Minion 是一个以迭代推理为核心的 Python Agent 框架，自称为 "Agent's Brain"，当前处于 Alpha 阶段（v0.1.21）。其核心设计围绕 Brain 推理循环（Query → Solution → Check → Improve）展开，提供两种主要使用范式：推荐的 CodeAgent（Python 代码执行 + tool calling）与 Brain.step() 直接调用。
在上下文与 token 优化方面，Minion 实现了三项关键机制：Tool Search Tool (TST) 动态工具发现以减少 token 消耗、Auto-compact 通过历史摘要自动管理上下文窗口、Auto-decay 对超时大型工具响应自动落盘。框架支持 OpenAI、Azure OpenAI、Anthropic Claude、AWS Bedrock、LiteLLM（100+ 提供商）等多后端，并通过 providers 层进行统一抽象。扩展能力方面，内置模块化 Skills 系统、MCP 协议工具集成、可选浏览器自动化（browser-use）与 Gradio Web UI。配置体系支持项目/用户两级配置分层与环境变量注入（${VAR_NAME} 语法、env_file、environment 内联）。部署方式覆盖 PyPI 安装（pip install minionx）、源码安装与 Docker。
适用场景包括数学推理、代码生成与执行、竞赛级推理（如 AIME）、通用 Agent 任务编排、MCP 工具编排、多 Agent 协作（ensemble 工作流如多 worker + majority voting）及浏览器自动化任务。
在 Benchmark 表现上，项目声称 GSM8K 达 96%（DeepSeek-Chat）、HumanEval 达 98.2% pass@1（GPT-4o）、Game of 24 最难 20 题 100%、AIME 2024 达 26%（4/15），但均缺乏独立第三方复现验证。TST 的 "85% token reduction" 声明同样缺乏独立基准测试证据。
安装示例
pip install minionx
pip install minionx[all] # 全部可选依赖
快速上手 — CodeAgent
from minion.agents.code_agent import CodeAgent
agent = await CodeAgent.create(
name="Minion Code Assistant",
llm="your-model",
tools=all_tools,
)
async for event in await agent.run_async("your task here"):
print(event)
快速上手 — Brain
from minion.main.brain import Brain
brain = Brain()
obs, score, *_ = await brain.step(query="what's the solution 234*568")
print(obs)
局限与注意点：Alpha 阶段 API 稳定性无保证；无独立官网，文档完全依赖 GitHub 仓库内 docs/ 目录；Python 兼容范围为 3.8–3.11，3.12+ 未说明；多模态支持范围不明确；关联项目 minion-agent、minion-code 在 README 中提及但未给出具体仓库地址。