特点介绍

• 功能性：

Agent循环，上下文管理，记忆，mcp，skill

• 非功能性：

异常处理，日志

mini-agent 包下是项目代码，其中大部分都是模块化组件，包括 /tool，/skills。 agent.py 为核心，装配 Agent 以及运行逻辑。 cli.py 为命令行入口，负责与 Agent 通信。

快速上手

看项目 README_CN 快速上手项目，然后再看一下 /docs 下的文档

1. 用命令克隆项目

# 1. 直接从 GitHub 安装
uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git

# 2. 运行配置脚本（自动创建配置文件）
# macOS/Linux:
curl -fsSL https://raw.githubusercontent.com/MiniMax-AI/Mini-Agent/main/scripts/setup-config.sh | bash

# Windows (PowerShell):
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/MiniMax-AI/Mini-Agent/main/scripts/setup-config.ps1" -OutFile "$env:TEMP\setup-config.ps1"
powershell -ExecutionPolicy Bypass -File "$env:TEMP\setup-config.ps1"

2. 创建配置

# 编辑配置文件
nano ~/.mini-agent/config/config.yaml

填入您的 API Key 和对应的 API Base：

api_key: "YOUR_API_KEY_HERE"          # 填入第 1 步获取的 API Key
api_base: "https://api.minimaxi.com"  # 国内版
# api_base: "https://api.minimax.io"  # 海外版（如使用海外平台，请取消本行注释）
model: "MiniMax-M2.5"

学习过程

1. 配置项目启动
2. /examples 下有示例
3. /test 下有测试
4. 学习源码