amrita 0.1.1

A bot powered by NoneBot2

PROJ.Amrita 🌸 - 基于 NoneBot 的 LLM 聊天机器人框架

Amrita 是一个基于NoneBot2的强大聊天机器人框架，专为快速构建和部署智能聊天机器人而设计。它不仅是一个 CLI 工具，更是一个完整的 LLM 聊天机器人解决方案，支持多种大语言模型和适配器。

🌟 特性亮点

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

🚀 快速开始

安装

# 使用pip安装
pip install amrita

# 或者使用uv安装（推荐）
uv pip install amrita

创建项目

# 创建新项目
amrita create mybot

# 进入项目目录
cd mybot

# 启动机器人
amrita run

初始化现有项目

# 在当前目录初始化项目
amrita init

# 启动机器人
amrita run

🧠 核心功能

LLM 聊天插件

Amrita 内置了 SuggarChat 插件，基于 SuggarChat 的 LLM 模型，提供智能聊天功能。详见 SuggarChat 的文档。

📦 依赖管理

Amrita 使用uv进行依赖管理，提供两种安装模式：

# 基础安装(包含CLI)
pip install amrita

# 完整安装（包含完整的运行依赖）
pip install amrita[full]

🛠️ CLI 命令

命令	描述
amrita create	创建新项目
amrita init	初始化当前目录为项目
amrita run	运行项目
amrita version	查看版本信息
amrita check-dependencies	检查依赖
amrita proj-info	显示项目信息
amrita nb	直接运行 nb-cli 命令

🧩 插件系统

Amrita 采用插件化架构，支持：

• 内置聊天插件
• 自定义功能插件
• 工具插件扩展
• 事件钩子系统

📚 文档和资源

• 官方文档
• GitHub 仓库
• 问题反馈
• Chat功能文档

🤝 贡献

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

📄 许可证

本项目采用 GPL-3.0 许可证，详见LICENSE文件。