[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72437":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":16,"starSnapshotCount":16,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},72437,"Mini-Agent","MiniMax-AI\u002FMini-Agent","MiniMax-AI","A minimal yet professional single agent demo project that showcases the core execution pipeline and production-grade features of agents.","https:\u002F\u002Fwww.minimax.io\u002F",null,"Python",2769,413,15,25,0,17,77,178,51,109.85,"MIT License",false,"main",true,[27,28,29],"agent","llm","minimax","2026-06-12 04:01:05","# Mini Agent\n\nEnglish | [中文](.\u002FREADME_CN.md)\n\n**Mini Agent** is a minimal yet professional demo project that showcases the best practices for building agents with the MiniMax M2.5 model. Leveraging an Anthropic-compatible API, it fully supports interleaved thinking to unlock M2's powerful reasoning capabilities for long, complex tasks.\n\nThis project comes packed with features designed for a robust and intelligent agent development experience:\n\n*   ✅ **Full Agent Execution Loop**: A complete and reliable foundation with a basic toolset for file system and shell operations.\n*   ✅ **Persistent Memory**: An active **Session Note Tool** ensures the agent retains key information across multiple sessions.\n*   ✅ **Intelligent Context Management**: Automatically summarizes conversation history to handle contexts up to a configurable token limit, enabling infinitely long tasks.\n*   ✅ **Claude Skills Integration**: Comes with 15 professional skills for documents, design, testing, and development.\n*   ✅ **MCP Tool Integration**: Natively supports MCP for tools like knowledge graph access and web search.\n*   ✅ **Comprehensive Logging**: Detailed logs for every request, response, and tool execution for easy debugging.\n*   ✅ **Clean & Simple Design**: A beautiful CLI and a codebase that is easy to understand, making it the perfect starting point for building advanced agents.\n\n## Table of Contents\n\n- [Mini Agent](#mini-agent)\n  - [Table of Contents](#table-of-contents)\n  - [Quick Start](#quick-start)\n    - [1. Get API Key](#1-get-api-key)\n    - [2. Choose Your Usage Mode](#2-choose-your-usage-mode)\n      - [🚀 Quick Start Mode (Recommended for Beginners)](#-quick-start-mode-recommended-for-beginners)\n      - [🔧 Development Mode](#-development-mode)\n  - [ACP \\& Zed Editor Integration(optional)](#acp--zed-editor-integrationoptional)\n  - [Usage Examples](#usage-examples)\n    - [Task Execution](#task-execution)\n    - [Using a Claude Skill (e.g., PDF Generation)](#using-a-claude-skill-eg-pdf-generation)\n    - [Web Search \\& Summarization (MCP Tool)](#web-search--summarization-mcp-tool)\n  - [Testing](#testing)\n    - [Quick Run](#quick-run)\n    - [Test Coverage](#test-coverage)\n  - [Troubleshooting](#troubleshooting)\n    - [SSL Certificate Error](#ssl-certificate-error)\n    - [Module Not Found Error](#module-not-found-error)\n  - [Related Documentation](#related-documentation)\n  - [Community](#community)\n  - [Contributing](#contributing)\n  - [License](#license)\n  - [References](#references)\n\n## Quick Start\n\n### 1. Get API Key\n\nMiniMax provides both global and China platforms. Choose based on your network environment:\n\n| Version    | Platform                                                       | API Base                   |\n| ---------- | -------------------------------------------------------------- | -------------------------- |\n| **Global** | [https:\u002F\u002Fplatform.minimax.io](https:\u002F\u002Fplatform.minimax.io)     | `https:\u002F\u002Fapi.minimax.io`   |\n| **China**  | [https:\u002F\u002Fplatform.minimaxi.com](https:\u002F\u002Fplatform.minimaxi.com) | `https:\u002F\u002Fapi.minimaxi.com` |\n\n**Steps to get API Key:**\n1. Visit the corresponding platform to register and login\n2. Go to **Account Management > API Keys**\n3. Click **\"Create New Key\"**\n4. Copy and save it securely (key is only shown once)\n\n> 💡 **Tip**: Remember the API Base address corresponding to your chosen platform, you'll need it for configuration\n\n### 2. Choose Your Usage Mode\n\n**Prerequisites: Install uv**\n\nBoth usage modes require uv. If you don't have it installed:\n\n```bash\n# macOS\u002FLinux\u002FWSL\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Windows (PowerShell)\npython -m pip install --user pipx\npython -m pipx ensurepath\n# Restart PowerShell after installation\n\n# After installation, restart your terminal or run:\nsource ~\u002F.bashrc  # or ~\u002F.zshrc (macOS\u002FLinux)\n```\n\nWe offer two usage modes - choose based on your needs:\n\n#### 🚀 Quick Start Mode (Recommended for Beginners)\n\nPerfect for users who want to quickly try Mini Agent without cloning the repository or modifying code.\n\n**Installation:**\n\n```bash\n# 1. Install directly from GitHub\nuv tool install git+https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git\n\n# 2. Run setup script (automatically creates config files)\n# macOS\u002FLinux:\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FMiniMax-AI\u002FMini-Agent\u002Fmain\u002Fscripts\u002Fsetup-config.sh | bash\n\n# Windows (PowerShell):\nInvoke-WebRequest -Uri \"https:\u002F\u002Fraw.githubusercontent.com\u002FMiniMax-AI\u002FMini-Agent\u002Fmain\u002Fscripts\u002Fsetup-config.ps1\" -OutFile \"$env:TEMP\\setup-config.ps1\"\npowershell -ExecutionPolicy Bypass -File \"$env:TEMP\\setup-config.ps1\"\n```\n\n> 💡 **Tip**: If you want to develop locally or modify code, use \"Development Mode\" below\n\n**Configuration:**\n\nThe setup script creates config files in `~\u002F.mini-agent\u002Fconfig\u002F`. Edit the config file:\n\n```bash\n# Edit config file\nnano ~\u002F.mini-agent\u002Fconfig\u002Fconfig.yaml\n```\n\nFill in your API Key and corresponding API Base:\n\n```yaml\napi_key: \"YOUR_API_KEY_HERE\"          # API Key from step 1\napi_base: \"https:\u002F\u002Fapi.minimax.io\"  # Global\n# api_base: \"https:\u002F\u002Fapi.minimaxi.com\"  # China\nmodel: \"MiniMax-M2.5\"\n```\n\n**Start Using:**\n\n```bash\nmini-agent                                    # Use current directory as workspace\nmini-agent --workspace \u002Fpath\u002Fto\u002Fyour\u002Fproject  # Specify workspace directory\nmini-agent --version                          # Check version\n\n# Management commands\nuv tool upgrade mini-agent                    # Upgrade to latest version\nuv tool uninstall mini-agent                  # Uninstall if needed\nuv tool list                                  # View all installed tools\n```\n\n#### 🔧 Development Mode\n\nFor developers who need to modify code, add features, or debug.\n\n**Installation & Configuration:**\n\n```bash\n# 1. Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMini-Agent.git\ncd Mini-Agent\n\n# 2. Install uv (if you haven't)\n# macOS\u002FLinux:\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# Windows (PowerShell):\nirm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\n# Restart terminal after installation\n\n# 3. Sync dependencies\nuv sync\n\n# Alternative: Install dependencies manually (if not using uv)\n# pip install -r requirements.txt\n# Or install required packages:\n# pip install tiktoken pyyaml httpx pydantic requests prompt-toolkit mcp\n\n# 4. Initialize Claude Skills (Optional)\ngit submodule update --init --recursive\n\n# 5. Copy config template\n```\n\n**macOS\u002FLinux:**\n```bash\ncp mini_agent\u002Fconfig\u002Fconfig-example.yaml mini_agent\u002Fconfig\u002Fconfig.yaml\n```\n\n**Windows:**\n```powershell\nCopy-Item mini_agent\\config\\config-example.yaml mini_agent\\config\\config.yaml\n\n# 6. Edit config file\nvim mini_agent\u002Fconfig\u002Fconfig.yaml  # Or use your preferred editor\n```\n\nFill in your API Key and corresponding API Base:\n\n```yaml\napi_key: \"YOUR_API_KEY_HERE\"          # API Key from step 1\napi_base: \"https:\u002F\u002Fapi.minimax.io\"  # Global\n# api_base: \"https:\u002F\u002Fapi.minimaxi.com\"  # China\nmodel: \"MiniMax-M2.5\"\nmax_steps: 100\nworkspace_dir: \".\u002Fworkspace\"\n```\n\n> 📖 Full configuration guide: See [config-example.yaml](mini_agent\u002Fconfig\u002Fconfig-example.yaml)\n\n**Run Methods:**\n\nChoose your preferred run method:\n\n```bash\n# Method 1: Run as module directly (good for debugging)\nuv run python -m mini_agent.cli\n\n# Method 2: Install in editable mode (recommended)\nuv tool install -e .\n# After installation, run from anywhere and code changes take effect immediately\nmini-agent\nmini-agent --workspace \u002Fpath\u002Fto\u002Fyour\u002Fproject\n```\n\n> 📖 For more development guidance, see [Development Guide](docs\u002FDEVELOPMENT_GUIDE.md)\n\n> 📖 For more production deployment guidance, see [Production Guide](docs\u002FPRODUCTION_GUIDE.md)\n\n## ACP & Zed Editor Integration(optional)\n\nMini Agent supports the [Agent Communication Protocol (ACP)](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fprotocol) for integration with code editors like Zed.\n\n**Setup in Zed Editor:**\n\n1. Install Mini Agent in development mode or as a tool\n2. Add to your Zed `settings.json`:\n\n```json\n{\n  \"agent_servers\": {\n    \"mini-agent\": {\n      \"command\": \"\u002Fpath\u002Fto\u002Fmini-agent-acp\"\n    }\n  }\n}\n```\n\nThe command path should be:\n- If installed via `uv tool install`: Use the output of `which mini-agent-acp`\n- If in development mode: `.\u002Fmini_agent\u002Facp\u002Fserver.py`\n\n**Usage:**\n- Open Zed's agent panel with `Ctrl+Shift+P` → \"Agent: Toggle Panel\"\n- Select \"mini-agent\" from the agent dropdown\n- Start conversations with Mini Agent directly in your editor\n\n## Usage Examples\n\nHere are a few examples of what Mini Agent can do.\n\n### Task Execution\n\n*In this demo, the agent is asked to create a simple, beautiful webpage and display it in the browser, showcasing the basic tool-use loop.*\n\n![Demo GIF 1: Basic Task Execution](docs\u002Fassets\u002Fdemo1-task-execution.gif \"Basic Task Execution Demo\")\n\n### Using a Claude Skill (e.g., PDF Generation)\n\n*Here, the agent leverages a Claude Skill to create a professional document (like a PDF or DOCX) based on the user's request, demonstrating its advanced capabilities.*\n\n![Demo GIF 2: Claude Skill Usage](docs\u002Fassets\u002Fdemo2-claude-skill.gif \"Claude Skill Usage Demo\")\n\n### Web Search & Summarization (MCP Tool)\n\n*This demo shows the agent using its web search tool to find up-to-date information online and summarize it for the user.*\n\n![Demo GIF 3: Web Search](docs\u002Fassets\u002Fdemo3-web-search.gif \"Web Search Demo\")\n\n## Testing\n\nThe project includes comprehensive test cases covering unit tests, functional tests, and integration tests.\n\n### Quick Run\n\n```bash\n# Run all tests\npytest tests\u002F -v\n\n# Run core functionality tests\npytest tests\u002Ftest_agent.py tests\u002Ftest_note_tool.py -v\n```\n\n### Test Coverage\n\n- ✅ **Unit Tests** - Tool classes, LLM client\n- ✅ **Functional Tests** - Session Note Tool, MCP loading\n- ✅ **Integration Tests** - Agent end-to-end execution\n- ✅ **External Services** - Git MCP Server loading\n\n\n## Troubleshooting\n\n### SSL Certificate Error\n\nIf you encounter `[SSL: CERTIFICATE_VERIFY_FAILED]` error:\n\n**Quick fix for testing** (modify `mini_agent\u002Fllm.py`):\n```python\n# Line 50: Add verify=False to AsyncClient\nasync with httpx.AsyncClient(timeout=120.0, verify=False) as client:\n```\n\n**Production solution**:\n```bash\n# Update certificates\npip install --upgrade certifi\n\n# Or configure system proxy\u002Fcertificates\n```\n\n### Module Not Found Error\n\nMake sure you're running from the project directory:\n```bash\ncd Mini-Agent\npython -m mini_agent.cli\n```\n\n## Related Documentation\n\n- [Development Guide](docs\u002FDEVELOPMENT_GUIDE.md) - Detailed development and configuration guidance\n- [Production Guide](docs\u002FPRODUCTION_GUIDE.md) - Best practices for production deployment\n\n## Community\n\nJoin the MiniMax official community to get help, share ideas, and stay updated:\n\n- **WeChat Group**: Scan the QR code on [Contact Us](https:\u002F\u002Fplatform.minimaxi.com\u002Fdocs\u002Ffaq\u002Fcontact-us) page to join\n\n## Contributing\n\nIssues and Pull Requests are welcome!\n\n- [Contributing Guide](CONTRIBUTING.md) - How to contribute\n- [Code of Conduct](CODE_OF_CONDUCT.md) - Community guidelines\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## References\n\n- MiniMax API: https:\u002F\u002Fplatform.minimax.io\u002Fdocs\n- MiniMax-M2: https:\u002F\u002Fgithub.com\u002FMiniMax-AI\u002FMiniMax-M2\n- Anthropic API: https:\u002F\u002Fdocs.anthropic.com\u002Fclaude\u002Freference\n- Claude Skills: https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fskills\n- MCP Servers: https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fservers\n\n---\n\n**⭐ If this project helps you, please give it a Star!**\n","Mini Agent 是一个基于 MiniMax M2.5 模型构建的简洁而专业的单代理演示项目，展示了代理核心执行流程和生产级特性。该项目利用兼容 Anthropic 的 API 支持交错思维模式，解锁了模型处理复杂长任务的强大推理能力。其核心功能包括完整的代理执行循环、持久化记忆工具以跨会话保留关键信息、智能上下文管理自动总结对话历史、集成 15 种专业技能如文档处理与开发辅助、原生支持 MCP 工具接入知识图谱和网络搜索等，并提供详尽的日志记录便于调试。设计上追求清晰简洁，既适合初学者快速上手也方便开发者进一步扩展。适用于需要自动化处理文件系统操作、执行多步骤任务以及进行深度信息检索的应用场景。",2,"2026-06-11 03:42:03","high_star"]