[Telegram] | [LinuxDO] | [BiliBili]
本项目是一个让 各类 AI 客户端用 OpenAI Responses 风格接口调用人类的项目，并带有一个 Web 控制台界面，可以帮你组装 Tool Calling 请求，或设置自动回复规则。
通过这个项目，你可以让别人把你配置到 Agent 或 聊天机器人中，然后自己扮演 AI 助手被调用。
也可以在自己开发 Agent 的时候作为 Mock LLM 使用。
- 后端：Flask
- 前端：React + Vite + Ant Design
- 数据存储：SQLite
默认提供：
- 基于
.env的用户名密码登录，支持可选 TOTP - 支持
/v1/chat/completions、/v1/responses、/messages三套接口 - 会话列表与消息持久化能力，便于调试和查看上下文
- 自动化回复输出能力，支持定时流式发送、循环输出，条件判断自动回复等场景
- 可选 ntfy 消息推送
cd ./frontend
npm i
npm run build首页默认显示当前访问来源作为 API 基址；如需在构建时指定其他基址，可在构建前设置 VITE_HOMEPAGE_API_BASE_URL。
CHATAPI_USERNAME=用户名
CHATAPI_PASSWORD=密码
# 可选；如果不填，后端会在首次启动时自动生成并写入数据库配置表
# CHATAPI_SESSION_SECRET=随机字符串
CHATAPI_DB_PATH=./data/chatapi.sqlite3
CHATAPI_DATA_DIR=./data
CHATAPI_HOST=0.0.0.0
CHATAPI_PORT=443
CHATAPI_WEB_DIST_DIR=../frontend/dist
CHATAPI_TLS_CERT_FILE=../certs/server.crt
CHATAPI_TLS_KEY_FILE=../certs/server.keycd ./backend
uv sync
uv run main.pycd ./backend
uv sync
uv run main.pycd ./frontend
npm i
npm run dev先复制配置模板：
cp .env.example .env至少需要修改以下配置：
CHATAPI_USERNAME=admin
CHATAPI_PASSWORD=change-me
# 可选；如果不填，后端会在首次启动时自动生成并写入数据库配置表
# CHATAPI_SESSION_SECRET=change-this-session-secret如果部署配置保存在项目目录之外，可以设置外部 env 文件路径：
CHATAPI_ENV_FILE=/path/to/chatapi.env外部 env 文件与项目内 .env 使用相同格式，已存在的进程环境变量不会被文件中的值覆盖。
建议同时确认以下配置：
CHATAPI_DB_PATH=./data/chatapi.sqlite3
CHATAPI_DATA_DIR=./data
CHATAPI_HOST=0.0.0.0
CHATAPI_PORT=5000
CHATAPI_CORS_ORIGINS=http://localhost:5173,http://127.0.0.1:5173登录后可以在「系统设置」里启用并保存 API Key、站点标题、ntfy 地址、消息限流和 TOTP，这些不再需要放在 .env 里。
可选配置：
# 直接让 Flask 对外托管前端静态文件（例如 Vite build 后的 dist）
# CHATAPI_WEB_DIST_DIR=./frontend/dist
# 直接由 Flask 提供 HTTPS 时使用
# CHATAPI_TLS_CERT_FILE=./certs/server.crt
# CHATAPI_TLS_KEY_FILE=./certs/server.key
# 邮件发送可选配置：
# CHATAPI_EMAIL_FROM=noreply@kirari.fun
# CHATAPI_SMTP_HOST=smtp.example.com
# CHATAPI_RESEND_API_KEY=re_xxxxxxxxx
# CHATAPI_BREVO_API_KEY=YOUR_BREVO_API_KEY
# CHATAPI_TENCENTCLOUD_SECRET_ID=AKIDxxxxxxxxxxxxxxxx
# CHATAPI_TENCENTCLOUD_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# CHATAPI_TENCENTCLOUD_SES_REGION=ap-guangzhou
# 普通 SES 账号还需要模板 ID；模板数据会由程序动态生成。
# CHATAPI_TENCENTCLOUD_TEMPLATE_ID=100091注意:请确保您的系统正常,并且使用了在Github或F-Droid下载的Termux或者国内打包版本ZeroTermux,请确保系统应当为64位(Arm64或aarch64) 以保证能正常运行和部署,通过以下命令可以查询自己设备的架构,为了更好更方便的管理,可以使用文件管理器,如MT管理器,遇到问题可以先将项目更新到最新版本 或者询问AI,询问他人,为了避免豆包的疑惑行为,可以使用其他ai(如:DeepSeek,Qwen[千问]),如果遇到实在的bug请报告给创作者
uname -m输出数据根据以下查看,应当输出aarch64才满足条件 aarch64 说明:64位 ARM（ARMv8-A 或更高） armv7l 或 armv8l 说明:32位 ARM（ARMv7-A 或兼容） x86_64 说明:64位 x86 架构（Intel/AMD） i686 或 i386 说明:32位 x86 架构 riscv64 说明:RISC-V 64位架构 至少Android 5以上,最好Android 12以上
注意:本项目本身还是基于电脑端的没有手机端的优化支持,但目前还是可以在手机端上运行的,还有请确保您已更新termux的相关文件已更新最新 现在先来准备工作,输入以下指令，安装一些依赖等等
termux-setup-storage #给文件权限
termux-change-repo #更换镜像源,步骤:ok,↓↓,ok,等待跑完,反正就选中国(Chinese)
pkg update && pkg upgrade -y #更新一下
pkg install -y git wget curl vim binutils clang make pkg-config #安装一些必备依赖
pkg install -y python python-pip build-essential
pkg install -y libjpeg-turbo libpng freetype harfbuzz libtiff libwebp openjpeg
pip install uv
uname -m #再看一眼架构
pkg install -y nodejs #安装不可或缺的东西
node --version && npm --version #验证一下安装cd ~/
git clone https://github.com/zyf2007/ChatAPI.git
cd ChatAPI
cd frontend
npm i
npm run build首页默认显示当前访问来源作为 API 基址；如需在构建时指定其他基址，可在构建前设置 VITE_HOMEPAGE_API_BASE_URL。
先复制配置模板：
cd ~/ChatAPI/backend
cp .env.example .env至少需要修改以下配置：
CHATAPI_USERNAME=admin #用户名(管理员名称)
CHATAPI_PASSWORD=change-me #用户密码(管理员密码)
# 可选；如果不填，后端会在首次启动时自动生成并写入数据库配置表
# CHATAPI_SESSION_SECRET=change-this-session-secret如果部署配置保存在项目目录之外，可以设置外部 env 文件路径：
CHATAPI_ENV_FILE=/path/to/chatapi.env外部 env 文件与项目内 .env 使用相同格式，已存在的进程环境变量不会被文件中的值覆盖。
建议同时确认以下配置：
CHATAPI_DB_PATH=./data/chatapi.sqlite3
CHATAPI_DATA_DIR=./data
CHATAPI_HOST=0.0.0.0
CHATAPI_PORT=5000
CHATAPI_CORS_ORIGINS=http://localhost:5173,http://127.0.0.1:5173登录后可以在「系统设置」里启用并保存 API Key、站点标题、ntfy 地址、消息限流和 TOTP，这些不再需要放在 .env 里。
可选配置：
# 直接让 Flask 对外托管前端静态文件（例如 Vite build 后的 dist）
# CHATAPI_WEB_DIST_DIR=./frontend/dist
# 直接由 Flask 提供 HTTPS 时使用
# CHATAPI_TLS_CERT_FILE=./certs/server.crt
# CHATAPI_TLS_KEY_FILE=./certs/server.key
# 邮件发送可选配置：
# CHATAPI_EMAIL_FROM=noreply@kirari.fun
# CHATAPI_SMTP_HOST=smtp.example.com
# CHATAPI_RESEND_API_KEY=re_xxxxxxxxx
# CHATAPI_BREVO_API_KEY=YOUR_BREVO_API_KEY
# CHATAPI_TENCENTCLOUD_SECRET_ID=AKIDxxxxxxxxxxxxxxxx
# CHATAPI_TENCENTCLOUD_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# CHATAPI_TENCENTCLOUD_SES_REGION=ap-guangzhou
# 普通 SES 账号还需要模板 ID；模板数据会由程序动态生成。
# CHATAPI_TENCENTCLOUD_TEMPLATE_ID=100091cd ~/ChatAPI/backend
uv sync
uv run main.py由于需要同时启动,所以需要新建一个会话,两个会话要分别运行后端和前端,前端主要提供了用于管理的网页
cd ~/ChatAPI/frontend
npm i
npm run dev以下示例假设：
- 前端静态文件目录：
/path/to/ChatAPI/frontend/dist - 后端地址：
http://127.0.0.1:5000 - 域名：
chat.example.com
server {
listen 80;
server_name chat.example.com;
root /path/to/ChatAPI/frontend/dist;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
location /api/ {
proxy_pass http://127.0.0.1:5000/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /v1/ {
proxy_pass http://127.0.0.1:5000/v1/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}如果要启用 HTTPS，建议由 Nginx 处理证书，而不是直接使用 Flask 内置服务。
如果不想额外部署 Nginx，也可以直接让 Flask 对外同时提供 API 和前端静态文件：
CHATAPI_WEB_DIST_DIR=./frontend/dist设置后：
/api/*和/v1/*继续走后端接口- 其他路径会从该目录下直接返回静态文件
- 当请求路径不存在且目录中包含
index.html时，会自动回退到index.html，可用于前端单页应用路由
curl https://127.0.0.1:5000/v1/responses \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk-i-love-you-hutao' \
-d '{
"model": "胡桃酱",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "在这里打字就可以和胡桃酱本人对话！"
}
]
}
],
"stream": true
}'
Anthropic Messages 兼容接口使用 /messages，例如：
curl https://127.0.0.1:5000/messages \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk-i-love-you-hutao' \
-d '{
"model": "claude-sonnet-4-20250514",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "你好"
}
],
"stream": true
}'