内容
# AION 智能代理
自托管 AI 智能代理平台，集成 MCP 工具、多级内存（STM/LTM）、
YAML 配置文件、技能和计划模式，支持结构化多步骤工作。
[](https://github.com/AION-by-ASA-Computer/AION_Agent/actions/workflows/ci.yml)
[](https://scorecard.dev/viewer/?uri=github.com/AION-by-ASA-Computer/AION_Agent)
[](LICENSE)
[](https://www.python.org/)
[](https://fastapi.tiangolo.com/)
[](https://haystack.deepset.ai/)
[](https://nextjs.org/)
[](https://react.dev/)
[](https://www.typescriptlang.org/)
[](https://docs.docker.com/compose/)
[](https://redis.io/)
[](https://www.sqlite.org/)
[](docs/mcp/)
[](https://caddyserver.com/)
**商业网站：** [https://aion-asa.com](https://aion-asa.com) · **意大利 README：** [README.it.md](README.it.md) · **文档：** [docs/](docs/)
## 截图
### 聊天界面
<p align="center">
<img src="assets/images/chat-ui.png" alt="AION 聊天界面：流式聊天、计划停靠、附件" width="900" />
</p>
### 管理界面
<p align="center">
<img src="assets/images/admin-panel.png" alt="AION 管理界面：配置文件、用户、内存、代理数据库" width="900" />
</p>
## 快速开始（Docker）
推荐使用完整的 Docker 栈（Caddy + 后端 + 聊天界面 + 管理界面 + 文档 + Redis）运行 AION。
### 本地（HTTP，无域名）
```bash
git clone https://github.com/AION-by-ASA-Computer/AION_Agent.git
cd AION_Agent
cp .env.example .env
# 必需：设置您的 LLM 端点（参见 .env.example 中的 DEPLOY DOCKER 部分）
# AION_API_URL=http://host.docker.internal:11434/v1 # 主机上的 Ollama
# AION_MODEL=llama3.2
# DOMAIN=:80
./scripts/setup-aion-env.sh --docker
docker compose up -d --build
```
| URL | 服务 |
|-----|---------|
| http://localhost/ | 聊天界面 |
| http://localhost/admin | 管理界面 |
| http://localhost/docs/ | 文档 |
| http://localhost/api/health | 后端健康检查 |
### 生产环境（通过 Let's Encrypt 使用 HTTPS）
```bash
cp .env.example .env
# 设置 DOMAIN=your.example.com, LETS_ENCRYPT_EMAIL, AION_PUBLIC_API_URL, 机密
./scripts/setup-aion-env.sh --docker
docker compose up -d --build
```
Caddy 自动配置 TLS。只需一个 DNS `A` 记录指向服务器即可。
详情：[docs/deployment/docker.md](docs/deployment/docker.md)
### 预构建镜像（GHCR）
在每个 [GitHub Release](https://github.com/AION-by-ASA-Computer/AION_Agent/releases) 上发布。生产环境中固定版本：
```bash
export AION_VERSION=0.1.0
docker compose -f docker-compose.yml -f docker-compose.ghcr.yml pull
docker compose -f docker-compose.yml -f docker-compose.ghcr.yml up -d --no-build
```
参见 [docs/opensource/releases.md](docs/opensource/releases.md)。
### 开发环境（热重载）
仅限 API + 聊天界面 + Redis - 在需要时通过 `pnpm dev` 运行管理界面和文档：
```bash
docker compose -f docker-compose.dev.yml up
```
## 功能
| 领域 | 描述 |
|------|-------------|
| **聊天界面** (`chat-ui/`) | 主要的 Next.js 客户端：SSE 流式传输、附件、计划停靠 |
| **管理界面** (`admin-ui/`) | 配置文件、用户、内存、代理数据库管理 |
| **MCP 工具** | 动态_stdio/SSE 工具；`config_std/mcp_registry.yaml` 中的注册表 |
| **内存** | STM 窗口、LTM 提取（MemPalace）、SQLite + FTS 历史记录 |
| **配置文件和技能** | YAML 配置文件；Markdown 技能带有 frontmatter |
| **计划模式** | 工具优先计划、人工审批、后台执行 |
| **Docker** | 生产环境栈，带有 Caddy 路径路由；开发环境组合，带有热重载 |
## 默认凭证
当启用管理员身份验证（默认）时： **`admin` / `admin`** - 在首次登录时更改密码。
聊天身份验证是可选的（`AION_CHAT_PASSWORD_AUTH=0` 打开聊天，无需登录；适用于本地开发）。
为生产环境生成机密：
```bash
openssl rand -hex 32 # AION_CHAT_AUTH_SECRET（如果启用聊天密码身份验证）
```
## 项目布局
```text
src/ FastAPI 后端、代理管道、内存、MCP 管理器
chat-ui/ 主要的 Next.js 聊天客户端
admin-ui/ 管理仪表盘（Next.js）
website/ Docusaurus 文档站点
config_std/ 提交的配置文件模板（在设置时同步到 config/）
mcp_servers_std/ 提交的 MCP 服务器源代码
docs/ 文档源
data/ 运行时数据（gitignored；评估fixtures 白名单）
```
参见 [docs/architecture/source-tree.md](docs/architecture/source-tree.md)。
## 本地开发（无 Docker）
**前提条件：** Python 3.13+，[uv](https://github.com/astral-sh/uv)，[pnpm](https://pnpm.io/) 9+，OpenAI 兼容的 LLM。
```bash
cp .env.example .env
# 设置 AION_API_URL、AION_MODEL、AION_LLM_API_KEY
./scripts/setup-aion-env.sh
uv venv && uv pip install -r requirements.txt
# 终端 1 — API（端口 8001，需要单个工作进程）
uvicorn src.api.main:app --reload --reload-exclude data/sessions
# 终端 2 — 聊天界面（端口 8003）
cd chat-ui && pnpm install && pnpm dev
```
打开 http://localhost:8003。可选的管理界面：`cd admin-ui && pnpm dev --webpack`（端口 3870）。
```bash
#精选的 CI 测试套件（无实时 LLM）
./scripts/run_ci_tests.sh
# 校验
uv run ruff check --config ruff.toml src/
uv run ruff format --check --config ruff.toml src/
```
**约束：** 后端必须使用 **一个工作进程** 运行；JS 包中使用 **pnpm**；在脚本中导入 `src.aion_env` 之前读取 `os.environ`。
助手入职： [AGENTS.md](AGENTS.md)，[CLAUDE.md](CLAUDE.md)。
## 贡献
参见 [CONTRIBUTING.md](CONTRIBUTING.md)。在该仓库上打开 PR 至 **`main`**。
## 文档
渲染站点：从 `website/` 构建或在 `docs/` 中阅读源代码。
| 主题 | 路径 |
|-------|------|
| 架构 | [docs/architecture/](docs/architecture/) |
| 配置 / 环境变量 | [docs/configuration/](docs/configuration/) |
| API 和运行时 | [docs/api-and-runtime/](docs/api-and-runtime/) |
| MCP | [docs/mcp/](docs/mcp/) |
| 安全 | [docs/security/](docs/security/) |
## 遥测
OpenTelemetry 和 Opik 钩子存在但**默认关闭**（`AION_OTEL_ENABLED=0`）。默认配置中无电话分析。
## 安全
私下报告漏洞 - [SECURITY.md](SECURITY.md)。
## 免责声明
**AION 智能代理正在积极开发中。** API、配置和行为可能会在版本之间更改，恕无事先通知。
软件按 **“原样”** 提供，不附带任何形式的保证。AION / ASA Computer **不承担任何责任** 因使用该项目在任何环境（包括生产环境）中而导致的损害、数据丢失、安全事件或运营问题。
您负责评估适合您的使用场景、确保部署安全并遵守适用的法律和第三方许可条款。
## 许可证
[Apache License 2.0](LICENSE)。第三方通知： [NOTICE](NOTICE)。
## 星级历史
[](https://www.star-history.com/#AION-by-ASA-Computer/AION_Agent&type=date&legend=top-left)
