YOLO Studio 文档站

切换主题

快速开始 ​

按下面步骤完成首次安装和启动。

前置环境 ​

  • Conda（Anaconda 或 Miniconda）
  • Python 3.11（由 Conda 环境管理）
  • Node.js >= 18
  • Java >= 21
  • MySQL 8.x
  • Redis 7.x

1. 克隆并进入仓库根目录 ​

bash
git clone https://github.com/Chengxiaoyu1119/YOLO-Studio-ECS.git YOLO-Studio
cd YOLO-Studio

2. 创建 Python 环境 ​

Conda 环境用于隔离 ML 服务依赖，项目固定使用 YOLO_Studio：

bash
conda env create -f docs/env/environment.yml
conda activate YOLO_Studio
python -m pip check

已有 yolo11_web 时，改为执行 conda rename -n yolo11_web YOLO_Studio。

3. 初始化数据库 ​

bash
mysql -u root -p yolo_studio < docs/env/yolo_studio.sql

数据库名 yolo_studio 保持小写，它与 Conda 环境名不是同一项。

4. 安装前端与文档依赖 ​

bash
cd apps/frontend
npm install
cd ../docs
npm install
cd ../..

5. 一键启动 ​

bat
cd apps
start_all.bat

脚本会先检查 YOLO_Studio 和核心 Python 依赖，再拉起各项服务。 ML 服务会连接本机 redis://127.0.0.1:6379/0 保存实时会话、事件和摄像头锁状态；手动启动 ML 服务时，请先设置 REALTIME_REDIS_URL=redis://127.0.0.1:6379/0。

6. 打开与验证 ​

  • 前端：http://localhost:8888
  • 后端健康：http://localhost:8080/actuator/health
  • ML 健康：http://localhost:5000/health

如果启动失败，继续查看项目使用说明和本地开发部署。