Mini-Agent

环境要求

• uv 包管理器（README 明确要求先安装）
• Python 环境（项目基于 Python 实现）
• 终端：Windows PowerShell 或 macOS/Linux shell
• 可用的 MiniMax M2.5 模型 API（Anthropic 兼容）

安装与启动步骤

1. 1安装 uv 工具链

   README 要求先安装 uv；节选中具体安装命令被截断，请按 uv 官方文档安装，装完重启终端。

2. 2安装 Mini-Agent

   用 uv 从 GitHub 直接安装，无需克隆仓库、不改代码，适合初学者快速体验。

   uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git

   复制

3. 3生成配置文件

   运行 setup 脚本自动创建 config 文件（该命令在节选中被截断，请以仓库 README 为准）。

4. 4启动 CLI

   安装完成后可在任意目录运行 mini-agent；加 --workspace 指定工作目录。

   mini-agent
   mini-agent --workspace /path/to/your/project

   复制

5. 5开发模式安装

   需要改代码时用可编辑模式安装，运行 mini-agent 即生效；也可用模块方式调试。

   uv tool install -e .
   uv run python -m mini_agent.cli

   复制

6. 6手动装依赖（备选）

   不使用 uv 时的备选方式：先装 requirements，或按 README 逐个安装依赖包。

   pip install -r requirements.txt
   pip install tiktoken pyyaml httpx pydantic requests prompt-toolkit mcp

   复制

7. 7运行测试验证

   执行测试套件确认安装完整，也可只跑核心功能测试。

   pytest tests/ -v
   pytest tests/test_agent.py tests/test_note_tool.py -v

   复制

如何确认成功

运行 mini-agent 可进入 CLI 界面并正常交互；或执行 pytest tests/ -v 全部测试通过。

常见问题

注意事项

• README 节选中 uv 安装命令和 setup 脚本命令被截断，请以 GitHub 仓库最新 README 为准。
• 命令中的 /path/to/your/project 需替换为真实工作目录。
• Windows 安装后需重启 PowerShell；macOS/Linux 可执行 source ~/.bashrc 或 ~/.zshrc。