Skip to main content

Mini-Agent

View GitHub Repository

​
Core Features

  • Complete Agent Execution Loop: A robust execution framework with built-in tools for file system and shell operations
  • Persistent Memory: Through the built-in Session Note Tool, the Agent can retain key information across multiple sessions
  • Intelligent Context Management: Automatically summarizes conversation history, handling configurable token limits for unlimited task lengths
  • Integrated Claude Skills: 15 built-in professional skills covering document processing, design, testing, and development
  • Integrated MCP Tools: Native support for MCP protocol, easily connecting to knowledge graphs, web search, and other tools
  • Comprehensive Logging: Detailed logs for every request, response, and tool execution for easy debugging
  • Clean Design: Beautiful command-line interface and easy-to-understand codebase, making it an ideal starting point for building advanced Agents

​
Usage Examples

​
Task Execution

Ask the Agent to create a clean and beautiful webpage and display it in the browser, demonstrating the basic tool usage loop. CreateWeb

​
Using Claude Skill (e.g., PDF Generation)

The Agent uses Claude Skill to create professional documents (such as PDF or DOCX) based on user requests, demonstrating its powerful advanced capabilities. Claude Skill

​
Web Search and Summary (MCP Tool)

The Agent uses web search tools to find the latest information online and summarize it for the user. Web Search

​
Quick Start

​
1. Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh

# After installation, restart terminal or run:
source ~/.bashrc  # or ~/.zshrc

​
2. Install Mini Agent

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

​
3. Run Configuration Script

curl -fsSL https://raw.githubusercontent.com/MiniMax-AI/Mini-Agent/main/scripts/setup-config.sh | bash

​
4. Configure API Key

The configuration script will create a config file in ~/.mini-agent/config/. Edit this file: 
nano ~/.mini-agent/config/config.yaml
Enter your API Key and corresponding API Base: 
api_key: "YOUR_API_KEY_HERE"          # Enter your API Key
api_base: "https://api.minimax.io"  
model: "MiniMax-M2.1"

​
5. Start Using

mini-agent                                    # Use current directory as workspace
mini-agent --workspace /path/to/your/project  # Specify workspace directory
mini-agent --version                          # View version info

# Management commands
uv tool upgrade mini-agent                    # Upgrade to latest version
uv tool uninstall mini-agent                  # Uninstall tool
uv tool list                                  # View all installed tools

​
Development Mode

This mode is suitable for developers who need to modify code, add features, or debug. Installation and Configuration Steps: 
# 1. Clone repository
git clone https://github.com/MiniMax-AI/Mini-Agent.git
cd Mini-Agent

# 2. Sync dependencies
uv sync

# 3. Initialize Claude Skills (optional)
git submodule update --init --recursive

# 4. Copy configuration template
cp mini_agent/config/config-example.yaml mini_agent/config/config.yaml

# 5. Edit configuration file
vim mini_agent/config/config.yaml
Enter your API Key and corresponding API Base: 
api_key: "YOUR_API_KEY_HERE"          # Enter your API Key
api_base: "https://api.minimax.io"  
model: "MiniMax-M2.1"
max_steps: 100
workspace_dir: "./workspace"
Running Methods: 
# Method 1: Run as module directly (for debugging)
uv run python -m mini_agent.cli

# Method 2: Install in editable mode (recommended)
uv tool install -e .
mini-agent
mini-agent --workspace /path/to/your/project
For more development guidance, please refer to Development Guide

​
ACP & Zed Editor Integration

Mini Agent supports Agent Communication Protocol (ACP) for integration with code editors like Zed. Setting up in Zed Editor:
  1. Install Mini Agent in development mode or tool mode
  2. Add the following to your Zed settings.json:
{
  "agent_servers": {
    "mini-agent": {
      "command": "/path/to/mini-agent-acp"
    }
  }
}
Command Path:
  • If installed via uv tool install: use the output of which mini-agent-acp
  • Development mode: ./mini_agent/acp/server.py
Usage:
  • Use Ctrl+Shift+P → “Agent: Toggle Panel” to open Zed’s Agent panel
  • Select “mini-agent” from the Agent dropdown
  • Start chatting with Mini Agent directly in the editor