Ultralytics YOLOv8官方文档https://docs.ultralytics.com/zhYOLOYOU ONLY LOOK ONCE安装方式有2种1是通过pip安装2是通过git克隆源码安装。一、第1种安装方法pip安装第一步创建并激活 Python 虚拟环境使用虚拟环境可以隔离项目依赖避免不同项目之间的库版本冲突1、创建虚拟环境python3 -m venv yolov8_env如果创建失败显示以下The virtual environment was not created successfully because ensurepip is not available. On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.apt install python3.8-venvYou may need to use sudo with that command. After installing the python3-venv package, recreate your virtual environment.解决方法查看当前的python3版本python3 --version根据错误提示你需要安装 Python 3.8 的 venv 包。sudo apt install python3.8-venv问题解决后再重新创建虚拟环境。2、激活虚拟环境source yolov8_env/bin/activate一次创建后后续不需要重新创建下次使用时直接激活。激活后你的终端提示符前会出现 (yolov8_env) 字样。同时在文件夹也能看到yolov8_env的文件夹。第二步安装 ultralytics 包这是 YOLOv8 的官方库包含了模型、训练工具和推理接口。为了加快下载速度可以使用国内的镜像源。pip install ultralytics -i https://pypi.tuna.tsinghua.edu.cn/simple第三步验证安装执行一条简单的命令来检查环境是否配置成功。yolo predict modelyolov8n.pt source‘https://ultralytics.com/images/bus.jpg’这个命令会自动下载一个预训练的轻量级模型 (yolov8n.pt)并对示例图片进行检测。如果一切顺利你会看到运行日志并且最终告诉你结果保存在哪个文件夹里通常是 runs/detect/predict。如果想卸载在终端中执行以下命令即可pip uninstall ultralytics运行后系统会询问你是否确认删除输入 y 即可完成卸载。注意如果你当初是在虚拟环境中安装的请务必先激活对应的虚拟环境再执行上述命令。为了确保卸载干净可以尝试导入该模块进行验证python -c “import ultralytics”如果系统提示 ModuleNotFoundError: No module named ‘ultralytics’就说明已经成功卸载了。关闭虚拟环境deactivate如果需要删除虚拟环境则在退出虚拟环境后rm -rf my_project_env执行后可以看到文件夹已经被删掉了。也可以直接删除文件夹。二、第2种安装方法从github克隆源代码编译安装第一步安装 Git 和基础依赖更新包列表sudo apt update安装 Git 和其他必要工具sudo apt install git python3-pip第二步克隆 Ultralytics 仓库克隆官方仓库git clone https://github.com/ultralytics/ultralytics这个试过成功了或者使用国内镜像加速如果官方访问慢git clone https://gitclone.com/github.com/ultralytics/ultralytics.git这个我没试过进入项目目录cd ultralytics第三步创建并激活虚拟环境推荐如果之前没有安装 python3.8-venvsudo apt install python3.8-venv创建虚拟环境python3 -m venv yolov8_env激活虚拟环境source yolov8_env/bin/activate第四步安装依赖和项目安装项目依赖pip install -e .-e 参数表示以可编辑模式安装你对代码的修改会立即生效出现问题ERROR: File “setup.py” not found. Directory cannot be installed in editable mode: /home/yunhui/ultralytics(A “pyproject.toml” file was found, but editable mode currently requires a setup.py based build.)这个错误是因为你使用的 pip 版本与项目采用的 pyproject.toml 标准不完全兼容导致的。解决方法升级 pip 到最新版本使其能原生支持基于 pyproject.toml 的可编辑安装。pip install --upgrade pip然后再pip install -e .第五步验证安装终端输入以下命令测试yolo predict modelyolov8n.pt source‘https://ultralytics.com/images/bus.jpg’网络原因没有测试成功
