YOLO Studio 文档站

切换主题

项目使用说明 ​

这页面向第一次接触项目的用户，重点说明如何启动并开始使用。

1. 项目调用链路 ​

浏览器 -> Java 后端(8080) -> Python ML 服务(5000)

权限、日志和业务数据由后端统一管理，模型推理运行在 ML 服务。

2. 首次使用 ​

  1. 准备 MySQL、Redis、Java 21、Node.js 18+ 和 Conda。
  2. 在仓库根目录执行 conda env create -f docs/env/environment.yml，创建 YOLO_Studio。
  3. 导入 docs/env/yolo_studio.sql。
  4. 安装前端和文档站 npm 依赖。
  5. 启动后端、ML 服务和前端。
  6. 打开 http://localhost:8888。

YOLO_Studio 是 Conda 环境；yolo_studio 是 MySQL 数据库。

3. 两种启动方式 ​

方式 A：一键启动 ​

bat
cd apps
start_all.bat

脚本会先校验 YOLO_Studio。MySQL、Redis 和 JDK 路径是本机配置，换电脑后需按安装位置调整。

方式 B：分模块启动 ​

每段命令在独立终端执行：

bat
:: 后端
cd apps\backend
mvnw.cmd spring-boot:run

:: ML
conda activate YOLO_Studio
cd apps\ml-service
python app.py

:: 前端
cd apps\frontend
npm install
npm run dev

4. 常用地址 ​

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

5. 常见问题 ​

  • ML 启动时报缺包：执行 conda activate YOLO_Studio、python -m pip install -r docs/env/requirements.txt、python -m pip check。
  • GPU 不可用：执行 python -c "import torch; print(torch.cuda.is_available())"。
  • 数据库没初始化：登录和任务记录会异常。
  • 端口被占用：释放 8888/8080/5000/6379/3306 或修改对应配置。