AmritaBot - 基于 NoneBot 与 AmritaCore 的 Agent Bot 项目
Amrita 是一个基于NoneBot2与AmritaCore的强大聊天机器人项目，专为快速构建和部署智能聊天机器人而设计。它是一个完整的 LLM 聊天机器人解决方案，具有强大的功能和灵活性。
🌟 特性亮点
- 供应商无关性: 基于AmritaCore原生开发，原生支持Anthropic/OpenAI/DeepSeek/Gemini等多种厂商。
- 多模态能力: 支持处理图像等多媒体内容
- 灵活适配: 原生支持 Onebot-V11 协议，轻松对接 QQ 等平台
- 智能会话管理: 内置会话控制和历史存储管理
- 插件化架构: 模块化设计，易于扩展和定制，复用NoneBot2插件系统
- 开箱即用: 预设丰富的回复模板和功能配置
- CLI 工具: 一体化命令行管理工具，简化开发和部署流程
- Agent: 支持Agent推理
- 智能上下文管理: 支持智能Session管理
- Web UI: 集成 Web UI，提供可视化管理界面，基于 FastAPI + React 19 + ShadCN UI + TailwindCSS V4 构建。
- MCP: 源生MCP Client集成
📚 文档和资源
官方文档的源文件位于独立的 amrita-docs 仓库， 通过 Git 子模块挂载在本仓库的
website/目录 —— 即此处是文档的唯一事实源， 本仓库不再复制一份。克隆时请带上子模块：git clone --recurse-submodules https://github.com/AmritaBot/AmritaBot.git已克隆的仓库补拉子模块：
git submodule update --init --recursive文档站在
website/内单独构建：cd website && npm install && npm run docs:dev。
📦 安装
使用模板创建
# 需要先安装模板：pip install amctl-template-ambot
amctl create -t ambot
手动安装
uv add amrita
⚙️ 环境变量参考
所有配置通过项目根目录的 .env 文件（或系统环境变量）注入，NoneBot 启动时自动读取。
以下按来源分类：Amrita 自定义（get_plugin_config 读取）、NoneBot 官方（get_driver().config 读取）。
Amrita 自定义配置
| 变量 | 默认值 | 说明 |
|---|---|---|
LOG_DIR |
logs |
日志目录（含 realtime.jsonl 实时日志、event.json 事件追溯） |
MAX_EVENT_RECORD |
1000 |
事件追溯（event.json）最大记录条数 |
ADMIN_GROUP |
-1 |
管理员群组 ID（-1 表示未设置；0~10000 的非法值自动重置为 -1） |
AMRITA_LOG_LEVEL |
WARNING |
Amrita 日志级别：DEBUG/INFO/WARNING/ERROR/CRITICAL |
PUBLIC_GROUP |
0 |
公开群组 ID（Bot 对外展示） |
BOT_NAME |
Amrita |
机器人名称 |
RATE_LIMIT |
5 |
请求速率限制（间隔秒） |
DISABLE_BUILTIN_MENU |
false |
是否禁用内置菜单 |
AUTO_APPROVE_FRIEND_REQUEST |
true |
是否自动通过好友申请 |
AUTO_APPROVE_GROUP_REQUEST |
true |
是否自动通过拉群申请 |
USAGE_CHECK_TIME |
400 |
用量统计添加间隔（毫秒） |
NO_AMRITA_FLAG |
false |
是否禁用 /amrita 信息输出 |
WEBUI_ENABLE |
true |
是否启用 WebUI |
WEBUI_USER_NAME |
admin |
WebUI 登录用户名 |
WEBUI_PASSWORD |
admin123 |
WebUI 登录密码（出厂默认值，使用默认密码时 WebUI 会拒绝访问，必须修改） |
NO_ENV_EDITOR |
true |
是否禁用 WebUI 的 Dotenv 编辑（默认禁用防敏感数据泄露；为 true 时页面提示不可用，读写接口均拒绝；需要编辑时设为 false） |
NoneBot 官方配置
| 变量 | 默认值 | 说明 |
|---|---|---|
SUPERUSERS |
[] |
超级用户列表（JSON 数组，如 ["3196373166"]），拥有最高权限（LitePerm 管理员、自动清理白名单） |
COMMAND_START |
["/"] |
命令起始符（聊天命令前缀、菜单命令解析） |
LOG_LEVEL |
INFO |
NoneBot 日志级别（ORM 等插件跟随） |
ENVIRONMENT |
prod |
运行环境：dev/prod |
DRIVER |
~fastapi |
NoneBot 驱动器（WebUI/API 依赖 FastAPI 驱动） |
HOST |
127.0.0.1 |
服务监听地址 |
PORT |
8080 |
服务监听端口（WebUI 默认使用 11451） |
前端开发环境
| 变量 | 默认值 | 说明 |
|---|---|---|
AMRITA_API_TARGET |
http://127.0.0.1:11451 |
dev server 的 API/WS 代理目标（bun run dev 时生效） |
提示：
.env可通过 WebUI「系统信息 -> Dotenv 编辑」在线查看和修改；修改后需重启生效。
🛠️ 开发
环境要求
一键开发运行（后端 + 构建前端）
bash scripts/dev-development.sh
依次执行：清理构建产物 -> 构建前端（含类型检查）-> 启动后端（uv run ambot run）。
常用参数：
bash scripts/dev-development.sh --skip-clean # 跳过清理
bash scripts/dev-development.sh --skip-typecheck # 构建时跳过类型检查
bash scripts/dev-development.sh --no-restart # 仅清理 + 构建，不重启后端
前端开发环境（dev server + 热更新）
bash scripts/dev-frontend.sh
依次执行：清理构建产物 -> 后台启动后端 -> 前台启动前端 dev server（bun run dev，
API/WS 自动代理到后端），Ctrl+C 退出时自动停止后端。
完整构建（发布）
bash scripts/full-build.sh
依次执行：清理构建产物 -> 构建前端（输出到 amrita/plugins/webui/service/static/）-> uv build 构建后端包（dist/ 下生成 wheel + sdist）。
其他脚本
bash scripts/cleanup.sh # 清理全部构建产物（static/、dist/、build/、egg-info、realtime.jsonl）
bash scripts/cleanup.sh --dry-run # 预演模式，仅列出将删除的内容
bash scripts/build-frontend.sh # 仅构建前端（含 typecheck）
前端开发（Bun dev server）
cd frontend
bun install
bun run dev # http://localhost:3000，/api 与 /amrita/ui/ws 代理到后端 11451
前端源码位于 frontend/（React 19 + TypeScript + ShadCN UI），构建产物输出到 amrita/plugins/webui/service/static/（已 gitignore，不提交）。
🤝 贡献
欢迎提交 Issue 和 Pull Request 来帮助改进 Amrita！
见贡献指南
📄 许可证
本项目采用 AGPL-3.0 许可证，详见LICENSE文件。
1 maintainer
Metadata
1 maintainer
Release files for amrita 1.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| amrita-1.14.0.tar.gz | 1.7 MB | Without provenance | Details for amrita-1.14.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| amrita-1.14.0-py3-none-any.whl | Python 3 | none | any | Details for amrita-1.14.0-py3-none-any.whl |
Total release size: 3.6 MB
Release files / amrita-1.14.0.tar.gz
| Download URL | amrita-1.14.0.tar.gz |
|---|---|
| Size | 1.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f2a6ff13717cdd5fd2b1968806e78c58d66336a7ffebbbe4f6d6a62d8b6ebfcd
|
|
BLAKE2b-256 checksum How to use checksums |
4d3a9e696024cdb1345c662d3c436a9569fb63f2ea55c96cd8132d7781276e59
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / amrita-1.14.0-py3-none-any.whl
| Download URL | amrita-1.14.0-py3-none-any.whl |
|---|---|
| Size | 1.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0c313516d6fc2bbd5a9fe043b4fefaa863f9dec203468bbf2a0790c5e8cf8040
|
|
BLAKE2b-256 checksum How to use checksums |
d60776c357b83f6b8f52060f43d8c7247ada0ed06b73c02a371624766741dfb8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for amrita 1.14.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
