从源码跑起来

从源码把 Aeria 跑起来：装好依赖，填一个 Discord 机器人的令牌和一个模型的密钥，启动，再打开本机的网页后台。

要准备的

• Python 3.11 以上；
• 一个 Discord 机器人：在 Discord 的开发者后台建一个应用、加一个 Bot，打开「Server Members Intent」和「Message Content Intent」两项；
• 一个模型的密钥：DeepSeek、OpenAI、Anthropic、通义千问，或者本机的 Ollama。

装

python3 -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
cp .env.example .env

在 .env 里填 DISCORD_TOKEN 和你用的那个模型的密钥（比如 DEEPSEEK_API_KEY）。密钥只放 .env，不放进配置文件，也不进 git。

跑

aeria

起来以后打开 http://127.0.0.1:8066，用上面那个密码登录。人格的设定、作息、记忆、插件都在网页后台里。

改网页后台

网页后台的前端在 webui_frontend/：

cd webui_frontend
npm ci
npm run dev

后台跑的是提交进仓库的那份构建产物（src/aeria/webui_dist/），改了前端要 npm run build 再提交产物。

对应的代码

• 命令入口：pyproject.toml 的 [project.scripts]（aeria → aeria.main:main）。
• 要填的环境变量：.env.example。
• 网页后台：src/aeria/webui.py；前端源码 webui_frontend/，构建产物 src/aeria/webui_dist/。
• 测试和关卡：见 3.4。

没做到的

• 还没有打好包的版本可以下载：现在只能从源码跑。
• 只在 macOS 上长期跑过；仓库里有 Dockerfile，Linux 上没有长期跑过，Windows 没试过。