5分钟快速开始
在本指南中,你将在5分钟内完成 Amrita 的安装和基本配置,创建你的第一个对话机器人。
前提条件
- Python 3.10+
- pip 包管理器
- 一个大语言模型 API Key(如 OpenAI、DeepSeek 等)
安装步骤
1. 安装 Amrita (CLI)
bash
pip install amrita2. 初始化项目
bash
amrita create
# 根据提示创建完bot
cd your-bot # 替换为你实际的Bot文件夹Details
$ amrita create
项目名称: Test
项目描述 []: My first robot
正在创建项目 Test...
已初始化空的 Git 仓库于 /home/johnrichard/Test/.git/
您现在想要安装依赖吗? [Y/n]: y
正在安装依赖......
您想要使用虚拟环境吗(这通常是推荐的做法)? [Y/n]: y
Using CPython
Creating virtual environment at:
in 2.86s
test @ file:///home/user/Test
in 16.22s
in 190ms
...
您的项目 Test 已完成创建!
您接下来可以运行以下命令启动项目:
cd Test
amrita run
$
3. 配置.env
dotenv
PORT=8080
ONEBOT_ACCESS_TOKEN=your-onebot-access-token # 你需要设置一个安全的访问令牌,就像密码一样。
WEBUI_USE_RNAME=admin
WEBUI_PASSWORD=your-webui-password # 你需要为Amrita的WebUI设置一个安全的密码。4. 启动机器人
bash
amrita run验证安装
访问http://127.0.0.1:8080可打开WebUI。

如果成功打开,恭喜你!Amrita 已成功运行。
