快速开始
三步启动本地开发环境,也可以使用 Docker 一键部署。
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。