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 sao chép Ultralytics Kho lưu trữ GitHub để có phiên bản mới nhất. Docker có thể được sử dụng để thực thi gói trong một vùng chứa bị cô lập, tránh cài đặt cục bộ.

Đồng hồ: Ultralytics YOLO Hướng dẫn bắt đầu nhanh

# Install the ultralytics package from PyPI
pip install ultralytics

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

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

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

# 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

# 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 .

# 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

# 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

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

Sử dụng Ultralytics với CLI

Các Ultralytics giao diện dòng lệnh ( CLI ) cho phép các lệnh đơn giản trên một dòng mà không cần 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 CLI Hướng dẫn để tìm hiểu thêm về cách sử dụng YOLO từ dòng lệnh.

yolo TASK MODE ARGS

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

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

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

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

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

CLI Hướng dẫn

Sử 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.

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 được đặt 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:

from ultralytics import settings

# View all settings
print(settings)

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

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 những cách sau:

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()

# 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

Hiểu về Cài đặt

Bảng dưới đây cung cấp tổng quan về các thiết lập có sẵn để điều chỉnh trong Ultralytics . Mỗi thiết lập được trình bày kèm theo giá trị ví dụ, kiểu dữ liệu và mô tả ngắn gọn.

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

CÂU HỎI THƯỜNG GẶP

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, điều này sẽ cài đặt ultralytics gói trực tiếp từ Python Chỉ mục 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 rằng công cụ dòng lệnh Git được cài đặt 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. Đối với CUDA môi trường, tốt nhất là cài đặt ultralytics, pytorch, Và pytorch-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 của 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 về Docker .

Làm thế nào để tôi 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, hãy 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 vào 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 kho lưu trữ GitHub Ultralytics .

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 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

Xem Hướng dẫn CLI đầy đủ để khám phá thêm nhiều 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 1 tháng

Bình luận