1. 环境准备

需要 Python 3.11+、Node.js,以及 MySQL / Redis(可用 Docker 启动)。

# 克隆主项目(Gitee / GitHub 任选其一)
git clone https://gitee.com/yc-chan/alphalom.git
git clone https://github.com/ycchencn/AlphaLom.git
cd alphalom

# 安装 Python 依赖
pip install -r requirements.txt

# 安装前端依赖
npm install

# 复制环境变量配置
cp .env.sample .env   # 填入 Redis、LLM API Key 等配置

2. 启动依赖服务

使用 docker-compose 启动 MySQL 与 Redis。

docker-compose up -d mysql redis

启动后端

python run_fastapi.py     # FastAPI :8080
python scheduler.py       # 定时任务调度器

启动前端

npm run dev               # Vite 开发服务器

构建生产包使用 npm run build。

3. Docker 一键部署

项目提供 docker.sh 脚本封装常用操作。

./docker.sh         # 查看帮助菜单

构建并启动

./docker.sh all 构建镜像并启动全部服务。

查看状态 / 日志

./docker.sh status、./docker.sh logs。

停止 / 清理

./docker.sh down、./docker.sh clean。

配置说明

关键配置通过 .env 与 config.py 管理。

常用环境变量

ENV · 运行环境(development / production)
WEB_HOST / WEB_PORT · 服务监听地址
WEB_WORKERS · worker 数量
REDIS_* · Redis 连接配置

大模型配置

通过 config.llm_model_setting 管理, 可配置 DeepSeek、豆包、GLM、SiliconFlow 等模型与对应 API Key。

启动成功后

访问 OpenAPI 文档,开始接入数据与接口。