Bỏ để qua phần nội dung

Bắt đầu nhanh

Cài đặt Ultralytics

Ultralytics cung cấp nhiều phương pháp cài đặt khác nhau bao gồm pip, conda và Docker. Cài đặt YOLO thông qua ultralytics Gói pip cho bản phát hành ổn định mới nhất hoặc bằng cách nhân bản Ultralytics Kho lưu trữ GitHub cho phiên bản cập nhật nhất. Docker có thể được sử dụng để thực thi gói trong một container bị cô lập, tránh cài đặt cục bộ.



Xem: Ultralytics YOLO Hướng dẫn Bắt đầu Nhanh

Cài đặt

PyPI - Python Phiên bản

Cài đặt ultralytics Gói sử dụng pip hoặc cập nhật cài đặt hiện có bằng cách chạy pip install -U ultralytics. Ghé thăm Python Chỉ số gói (PyPI) để biết thêm chi tiết về ultralytics gói: https://pypi.org/project/ultralytics/.

PyPI - Phiên bản Tải

# Install the ultralytics package from PyPI
pip install ultralytics

Bạn cũng có thể cài đặt ultralytics gói trực tiếp từ GitHub Kho. Điều này có thể hữu ích nếu bạn muốn có phiên bản phát triển mới nhất. Đảm bảo cài đặt công cụ dòng lệnh Git trên hệ thống của bạn. Các @main lệnh cài đặt main chi nhánh và có thể được sửa đổi sang chi nhánh khác, tức là @my-branch, hoặc bị xóa hoàn toàn về mặc định thành main nhánh.

# Install the ultralytics package from GitHub
pip install git+https://github.com/ultralytics/ultralytics.git@main

Conda là một trình quản lý gói thay thế cho pip cũng có thể được sử dụng để cài đặt. Truy cập Anaconda để biết thêm chi tiết tại https://anaconda.org/conda-forge/ultralytics. Ultralytics Kho lưu trữ nguyên liệu để cập nhật gói Conda là tại https://github.com/conda-forge/ultralytics-nguyên liệu/.

Phiên bản Conda Tải xuống Conda Công thức Conda Nền tảng Conda

# Install the ultralytics package using conda
conda install -c conda-forge ultralytics

Ghi

Nếu bạn đang cài đặt trong một CUDA Thực tiễn tốt nhất về môi trường là cài đặt ultralytics, pytorchpytorch-cuda trong cùng một lệnh để cho phép trình quản lý gói Conda giải quyết mọi xung đột hoặc cài đặt khác pytorch-cuda cuối cùng để cho phép nó ghi đè lên CPU-rành mạch pytorch gói nếu cần thiết.

# Install all packages together using conda
conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=11.8 ultralytics

Conda Docker Image

Ultralytics Hình ảnh Conda Docker cũng có sẵn từ DockerHub. Những hình ảnh này dựa trên Miniconda3 và là một cách đơn giản để bắt đầu sử dụng ultralytics trong môi trường Conda.

# Set image name as a variable
t=ultralytics/ultralytics:latest-conda

# Pull the latest ultralytics image from Docker Hub
sudo docker pull $t

# Run the ultralytics image in a container with GPU support
sudo docker run -it --ipc=host --gpus all $t  # all GPUs
sudo docker run -it --ipc=host --gpus '"device=2,3"' $t  # specify GPUs

Sao chép ultralytics kho lưu trữ nếu bạn quan tâm đến việc đóng góp cho sự phát triển hoặc muốn thử nghiệm với mã nguồn mới nhất. Sau khi nhân bản, điều hướng vào thư mục và cài đặt gói ở chế độ có thể chỉnh sửa -e Sử dụng pip.

Cam kết cuối cùng của GitHub GitHub commit activity

# Clone the ultralytics repository
git clone https://github.com/ultralytics/ultralytics

# Navigate to the cloned directory
cd ultralytics

# Install the package in editable mode for development
pip install -e .

Sử dụng Docker để dễ dàng thực thi ultralytics Đóng gói trong một thùng chứa cách ly, đảm bảo hiệu suất nhất quán và trơn tru trên các môi trường khác nhau. Bằng cách chọn một trong những quan chức ultralytics Hình ảnh từ Trung tâm Docker, bạn không chỉ tránh được sự phức tạp của việc cài đặt cục bộ mà còn được hưởng lợi từ việc truy cập vào môi trường làm việc đã được xác minh. Ultralytics cung cấp 5 hình ảnh Docker được hỗ trợ chính, mỗi hình ảnh được thiết kế để cung cấp khả năng tương thích và hiệu quả cao cho các nền tảng và trường hợp sử dụng khác nhau:

Phiên bản hình ảnh Docker Docker kéo

  • Dockerfile: GPU Hình ảnh đề xuất cho đào tạo.
  • Dockerfile-arm64: Tối ưu hóa cho kiến trúc ARM64, cho phép triển khai trên các thiết bị như Raspberry Pi và các nền tảng dựa trên ARM64 khác.
  • Dockerfile-cpu: Dựa trên Ubuntu CPU-chỉ phiên bản phù hợp với suy luận và môi trường không có GPU.
  • Dockerfile-jetson: Được thiết kế riêng cho NVIDIA Thiết bị Jetson, tích hợp GPU Hỗ trợ tối ưu hóa cho các nền tảng này.
  • Dockerfile-python: Hình ảnh tối thiểu chỉ với Python và các phụ thuộc cần thiết, lý tưởng cho các ứng dụng và phát triển nhẹ.
  • Dockerfile-conda: Dựa trên Miniconda3 với cài đặt conda của ultralytics gói.

Dưới đây là các lệnh để có được hình ảnh mới nhất và thực hiện nó:

# Set image name as a variable
t=ultralytics/ultralytics:latest

# Pull the latest ultralytics image from Docker Hub
sudo docker pull $t

# Run the ultralytics image in a container with GPU support
sudo docker run -it --ipc=host --gpus all $t  # all GPUs
sudo docker run -it --ipc=host --gpus '"device=2,3"' $t  # specify GPUs

Lệnh trên khởi tạo một Docker container với latest ultralytics ảnh. Các -it flag gán một giả TTY và duy trì stdin mở, cho phép bạn tương tác với vùng chứa. Các --ipc=host cờ đặt không gian tên IPC (Inter-Process Communication) cho máy chủ, điều này rất cần thiết để chia sẻ bộ nhớ giữa các tiến trình. Các --gpus all cờ cho phép truy cập vào tất cả các GPU có sẵn bên trong container, điều này rất quan trọng đối với các tác vụ yêu cầu GPU Tính toán.

Lưu ý: Để làm việc với các tệp trên máy cục bộ của bạn trong bộ chứa, hãy sử dụng ổ đĩa Docker để gắn thư mục cục bộ vào bộ chứa:

# Mount local directory to a directory inside the container
sudo docker run -it --ipc=host --gpus all -v /path/on/host:/path/in/container $t

Thay đổi /path/on/host với đường dẫn thư mục trên máy cục bộ của bạn và /path/in/container với đường dẫn mong muốn bên trong bộ chứa Docker cho khả năng truy cập.

Để sử dụng Docker nâng cao, vui lòng khám phá Ultralytics Hướng dẫn Docker.

Xem ultralytics pyproject.toml cho một danh sách các phụ thuộc. Lưu ý rằng tất cả các ví dụ ở trên cài đặt tất cả các phụ thuộc bắt buộc.

Mẹo

Yêu cầu PyTorch thay đổi tùy theo hệ điều hành và CUDA yêu cầu, vì vậy nên cài đặt PyTorch Đầu tiên hãy làm theo hướng dẫn tại pytorch .

PyTorch Hướng dẫn cài đặt

Dùng Ultralytics với CLI

Các Ultralytics giao diện dòng lệnh (CLI) cho phép các lệnh một dòng đơn giản mà không cần một Python môi trường. CLI không yêu cầu tùy chỉnh hoặc Python mã. Bạn có thể chỉ cần chạy tất cả các tác vụ từ thiết bị đầu cuối với yolo lệnh. Kiểm tra các CLI Hướng dẫn để tìm hiểu thêm về cách sử dụng YOLO từ dòng lệnh.

Ví dụ

Ultralytics yolo Các lệnh sử dụng cú pháp sau:

yolo TASK MODE ARGS

Xem tất cả ARGS đầy đủ Hướng dẫn cấu hình hoặc với yolo cfg CLI lệnh.

Đào tạo một mô hình phát hiện trong 10 kỷ nguyên với tốc độ học ban đầu là 0,01

yolo train data=coco8.yaml model=yolo11n.pt epochs=10 lr0=0.01

Dự đoán video YouTube bằng mô hình phân đoạn được đào tạo trước ở kích thước hình ảnh 320:

yolo predict model=yolo11n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320

Val một mô hình phát hiện được đào tạo trước ở kích thước lô 1 và kích thước hình ảnh 640:

yolo val model=yolo11n.pt data=coco8.yaml batch=1 imgsz=640

Xuất mô hình phân loại yolo11n sang ONNX định dạng ở kích thước hình ảnh 224 x 128 (không yêu cầu NHIỆM VỤ)

yolo export model=yolo11n-cls.pt format=onnx imgsz=224,128

Chạy các lệnh đặc biệt để xem phiên bản, xem cài đặt, chạy kiểm tra và hơn thế nữa:

yolo help
yolo checks
yolo version
yolo settings
yolo copy-cfg
yolo cfg

Cảnh báo

Các đối số phải được thông qua như arg=val cặp, chia cho một bằng = Ký và phân cách bằng khoảng trắng giữa các cặp. Không sử dụng -- Tiền tố đối số hoặc dấu phẩy , giữa các cuộc tranh luận.

  • yolo predict model=yolo11n.pt imgsz=640 conf=0.25
  • yolo predict model yolo11n.pt imgsz 640 conf 0.25 ❌ (mất tích =)
  • yolo predict model=yolo11n.pt, imgsz=640, conf=0.25 ❌ (không sử dụng ,)
  • yolo predict --model yolo11n.pt --imgsz 640 --conf 0.25 ❌ (không sử dụng --)

CLI Hướng dẫn

Dùng Ultralytics với Python

YOLO 'S Python giao diện cho phép tích hợp liền mạch vào Python dự án, giúp dễ dàng tải, chạy và xử lý đầu ra của mô hình. Được thiết kế với mục đích đơn giản và dễ sử dụng, Python giao diện cho phép người dùng nhanh chóng triển khai phát hiện đối tượng , phân đoạn và phân loại trong các dự án của họ. Điều này làm cho YOLO 'S Python giao diện là một công cụ vô giá cho bất kỳ ai muốn kết hợp các chức năng này vào Python dự án.

Ví dụ, người dùng có thể tải một mô hình, đào tạo nó, đánh giá hiệu suất của nó trên một tập hợp xác thực và thậm chí xuất nó sang ONNX định dạng chỉ với một vài dòng mã. Kiểm tra Hướng dẫn Python để tìm hiểu thêm về cách sử dụng YOLO trong bạn Python dự án.

Ví dụ

from ultralytics import YOLO

# Create a new YOLO model from scratch
model = YOLO("yolo11n.yaml")

# Load a pretrained YOLO model (recommended for training)
model = YOLO("yolo11n.pt")

# Train the model using the 'coco8.yaml' dataset for 3 epochs
results = model.train(data="coco8.yaml", epochs=3)

# Evaluate the model's performance on the validation set
results = model.val()

# Perform object detection on an image using the model
results = model("https://ultralytics.com/images/bus.jpg")

# Export the model to ONNX format
success = model.export(format="onnx")

Python Hướng dẫn

Ultralytics Cài đặt

Các Ultralytics Thư viện cung cấp một hệ thống quản lý cài đặt mạnh mẽ để cho phép kiểm soát chi tiết các thử nghiệm của bạn. Bằng cách sử dụng SettingsManager nằm trong ultralytics.utils module, người dùng có thể dễ dàng truy cập và thay đổi cài đặt của họ. Những cài đặt này được lưu trữ trong tệp JSON trong thư mục cấu hình người dùng môi trường và có thể được xem hoặc sửa đổi trực tiếp trong Python môi trường hoặc thông qua Giao diện dòng lệnh ( CLI ).

Kiểm tra cài đặt

Để hiểu rõ hơn về cấu hình hiện tại của cài đặt, bạn có thể xem trực tiếp:

Xem cài đặt

Bạn có thể sử dụng Python để xem cài đặt của bạn. Bắt đầu bằng cách nhập settings đối tượng từ ultralytics Module. In và trả lại cài đặt bằng các lệnh sau:

from ultralytics import settings

# View all settings
print(settings)

# Return a specific setting
value = settings["runs_dir"]

Ngoài ra, giao diện dòng lệnh cho phép bạn kiểm tra cài đặt của mình bằng một lệnh đơn giản:

yolo settings

Sửa đổi cài đặt

Ultralytics cho phép người dùng dễ dàng sửa đổi cài đặt của họ. Thay đổi có thể được thực hiện theo các cách sau:

Cập nhật cài đặt

Trong Python môi trường, gọi update phương pháp trên settings Đối tượng để thay đổi cài đặt của bạn:

from ultralytics import settings

# Update a setting
settings.update({"runs_dir": "/path/to/runs"})

# Update multiple settings
settings.update({"runs_dir": "/path/to/runs", "tensorboard": False})

# Reset settings to default values
settings.reset()

Nếu bạn thích sử dụng giao diện dòng lệnh, các lệnh sau sẽ cho phép bạn sửa đổi cài đặt của mình:

# Update a setting
yolo settings runs_dir='/path/to/runs'

# Update multiple settings
yolo settings runs_dir='/path/to/runs' tensorboard=False

# Reset settings to default values
yolo settings reset

Tìm hiểu cài đặt

Bảng dưới đây cung cấp tổng quan về các cài đặt có sẵn để điều chỉnh trong Ultralytics. Mỗi cài đặt được phác thảo cùng với một giá trị mẫu, kiểu dữ liệu và mô tả ngắn gọn.

TênGiá trị ví dụLoại dữ liệuSự miêu tả
settings_version'0.0.4'strUltralytics Phiên bản cài đặt (khác với Ultralytics Phiên bản pip)
datasets_dir'/path/to/datasets'strThư mục lưu trữ các bộ dữ liệu
weights_dir'/path/to/weights'strThư mục lưu trữ trọng số mô hình
runs_dir'/path/to/runs'strThư mục nơi thử nghiệm chạy được lưu trữ
uuid'a1b2c3d4'strMã định danh duy nhất cho cài đặt hiện tại
syncTrueboolCó đồng bộ hóa phân tích và sự cố với HUB hay không
api_key''strUltralytics Khóa API HUB
clearmlTrueboolCó nên sử dụng ghi nhật ký ClearML không
cometTrueboolCó nên sử dụng hay không Comet ML để theo dõi và trực quan hóa thử nghiệm
dvcTrueboolCó nên sử dụng DVC để theo dõi thử nghiệm và kiểm soát phiên bản hay không
hubTrueboolCó nên sử dụng hay không Ultralytics Tích hợp HUB
mlflowTrueboolCó nên sử dụng MLFlow để theo dõi thử nghiệm không
neptuneTrueboolCó nên sử dụng Neptune để theo dõi thử nghiệm không
raytuneTrueboolCó nên sử dụng Ray Tune để điều chỉnh siêu tham số không
tensorboardTrueboolCó nên sử dụng TensorBoard để trực quan hóa không
wandbTrueboolCó nên sử dụng ghi nhật ký Weights & Biases
vscode_msgTrueboolKhi phát hiện thiết bị đầu cuối VS Code, cho phép nhắc tải xuống tiện ích mở rộng Ultralytics -Snippets .

Khi bạn điều hướng qua các dự án hoặc thử nghiệm của mình, hãy nhớ truy cập lại các cài đặt này để đảm bảo rằng chúng được định cấu hình tối ưu cho nhu cầu của bạn.

FAQ

Làm thế nào để tôi cài đặt Ultralytics sử dụng pip?

Để cài đặt Ultralytics với pip, thực hiện lệnh sau:

pip install ultralytics

Đối với bản phát hành ổn định mới nhất, thao tác này sẽ cài đặt ultralytics Gói trực tiếp từ Python Chỉ số gói (PyPI). Để biết thêm chi tiết, hãy truy cập ultralytics gói trên PyPI.

Ngoài ra, bạn có thể cài đặt phiên bản phát triển mới nhất trực tiếp từ GitHub:

pip install git+https://github.com/ultralytics/ultralytics.git

Đảm bảo cài đặt công cụ dòng lệnh Git trên hệ thống của bạn.

Tôi có thể cài đặt không? Ultralytics YOLO sử dụng conda?

Có, bạn có thể cài đặt Ultralytics YOLO sử dụng conda bằng cách chạy:

conda install -c conda-forge ultralytics

Phương pháp này là một giải pháp thay thế tuyệt vời cho pip và đảm bảo khả năng tương thích với các gói khác trong môi trường của bạn. Cho CUDA môi trường, tốt nhất là cài đặt ultralytics, pytorchpytorch-cuda đồng thời giải quyết mọi xung đột:

conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=11.8 ultralytics

Để biết thêm hướng dẫn, hãy truy cập hướng dẫn bắt đầu nhanh Conda.

Những lợi thế của việc sử dụng Docker để chạy là gì? Ultralytics YOLO ?

Sử dụng Docker để chạy Ultralytics YOLO cung cấp một môi trường biệt lập và nhất quán, đảm bảo hiệu suất mượt mà trên các hệ thống khác nhau. Nó cũng loại bỏ sự phức tạp của cài đặt cục bộ. Hình ảnh Docker chính thức từ Ultralytics có sẵn trên Docker Hub , với các biến thể khác nhau được thiết kế riêng cho GPU , CPU , ARM64, NVIDIA Môi trường Jetson và Conda. Dưới đây là các lệnh để kéo và chạy hình ảnh mới nhất:

# Pull the latest ultralytics image from Docker Hub
sudo docker pull ultralytics/ultralytics:latest

# Run the ultralytics image in a container with GPU support
sudo docker run -it --ipc=host --gpus all ultralytics/ultralytics:latest

Để biết hướng dẫn chi tiết hơn về Docker, hãy xem hướng dẫn bắt đầu nhanh Docker.

Làm cách nào để sao chép Ultralytics kho lưu trữ để phát triển?

Để sao chép Ultralytics Kho lưu trữ và thiết lập môi trường phát triển, sử dụng các bước sau:

# Clone the ultralytics repository
git clone https://github.com/ultralytics/ultralytics

# Navigate to the cloned directory
cd ultralytics

# Install the package in editable mode for development
pip install -e .

Cách tiếp cận này cho phép bạn đóng góp cho dự án hoặc thử nghiệm với mã nguồn mới nhất. Để biết thêm chi tiết, hãy truy cập Ultralytics Kho lưu trữ GitHub.

Tại sao tôi nên sử dụng Ultralytics YOLO CLI ?

Các Ultralytics YOLO giao diện dòng lệnh ( CLI ) đơn giản hóa việc chạy các tác vụ phát hiện đối tượng mà không yêu cầu Python mã. Bạn có thể thực hiện các lệnh một dòng cho các tác vụ như đào tạo, xác thực và dự đoán trực tiếp từ thiết bị đầu cuối của bạn. Cú pháp cơ bản cho yolo Các lệnh là:

yolo TASK MODE ARGS

Ví dụ: để đào tạo một mô hình phát hiện với các tham số được chỉ định:

yolo train data=coco8.yaml model=yolo11n.pt epochs=10 lr0=0.01

Kiểm tra đầy đủ CLI Hướng dẫn khám phá thêm các lệnh và ví dụ sử dụng.

📅 Được tạo ra cách đây 1 năm ✏️ Đã cập nhật cách đây 12 ngày

Ý kiến