# MiniAgent - 基于 NoneBot2 的 LLM / Agent 聊天机器人框架

<p align="center">
  <img src="./logo/MiniAgent.svg" width="360" height="360" alt="MiniAgent Logo">
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Python-3.10+-blue?logo=python" alt="Python">
  <img src="https://img.shields.io/badge/License-AGPL--3.0-orange" alt="License">
  <img src="https://img.shields.io/badge/NoneBot-2.0+-red?logo=nonebot" alt="NoneBot">
</p>

MiniAgent 是一个基于 [NoneBot2](https://nonebot.dev/) 的聊天机器人框架，聚焦于 LLM / Agent 场景，支持多种大语言模型与协议适配器，并提供 CLI 与 WebUI 以便快速部署与运维。

> 重要声明：MiniAgent 基于上游项目 **[Amrita](https://github.com/LiteSuggarDEV/Amrita)** 二次开发与改进（上游作者/维护者：LiteSuggarDEV）。
> 本项目保留并尊重原项目的作者署名、许可证与相关版权声明。

## 🌟 特性亮点

- **多模型支持**：支持 OpenAI、DeepSeek、Gemini 等多种大语言模型
- **多模态能力**：支持处理图像等多媒体内容
- **灵活适配**：原生支持 OneBot V11 协议，轻松对接 QQ 等平台
- **智能会话管理**：内置会话控制和历史记录管理
- **插件化架构**：模块化设计，易于扩展和定制
- **开箱即用**：预设丰富的回复模板和功能配置
- **强大 CLI 工具**：一体化命令行管理工具，简化开发和部署流程
- **Web UI**：集成 Web UI，提供可视化管理界面
- **MCP**：支持 Model Context Protocol

## 📚 文档和资源

- 上游文档（Amrita）：https://amrita.suggar.top
- 上游仓库（Amrita）：https://github.com/LiteSuggarDEV/Amrita

## 🤝 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进 MiniAgent！

见 [贡献指南](CONTRIBUTING.md)

## 📄 许可证

本项目采用 **GNU AGPLv3** 许可证，详见 [LICENSE](LICENSE)。
