ultralytics/ultralytics

Install the ultralytics package, including all requirements, in a Python>=3.8 environment with PyTorch>=1.8.

pip install ultralytics

For alternative installation methods, including Conda, Docker, and building from source via Git, please consult the Quickstart Guide.

CLI

You can use Ultralytics YOLO directly from the Command Line Interface (CLI) with the yolo command:

# Predict using a pretrained YOLO model (e.g., YOLO11n) on an image
yolo predict model=yolo11n.pt source='https://ultralytics.com/images/bus.jpg'

The yolo command supports various tasks and modes, accepting additional arguments like imgsz=640. Explore the YOLO CLI Docs for more examples.

Python

Ultralytics YOLO can also be integrated directly into your Python projects. It accepts the same configuration arguments as the CLI:

from ultralytics import YOLO

# Load a pretrained YOLO11n model
model = YOLO("yolo11n.pt")

# Train the model on the COCO8 dataset for 100 epochs
train_results = model.train(
    data="coco8.yaml",  # Path to dataset configuration file
    epochs=100,  # Number of training epochs
    imgsz=640,  # Image size for training
    device="cpu",  # Device to run on (e.g., 'cpu', 0, [0,1,2,3])
)

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

# Perform object detection on an image
results = model("path/to/image.jpg")  # Predict on an image
results[0].show()  # Display results

# Export the model to ONNX format for deployment
path = model.export(format="onnx")  # Returns the path to the exported model

Discover more examples in the YOLO Python Docs.

Explore the Detection Docs for usage examples. These models are trained on the COCO dataset, featuring 80 object classes.

• mAP^val values refer to single-model single-scale performance on the COCO val2017 dataset. See YOLO Performance Metrics for details.
  Reproduce with yolo val detect data=coco.yaml device=0
• Speed metrics are averaged over COCO val images using an Amazon EC2 P4d instance. CPU speeds measured with ONNX export. GPU speeds measured with TensorRT export.
  Reproduce with yolo val detect data=coco.yaml batch=1 device=0|cpu

Refer to the Segmentation Docs for usage examples. These models are trained on COCO-Seg, including 80 classes.

• mAP^val values are for single-model single-scale on the COCO val2017 dataset. See YOLO Performance Metrics for details.
  Reproduce with yolo val segment data=coco.yaml device=0
• Speed metrics are averaged over COCO val images using an Amazon EC2 P4d instance. CPU speeds measured with ONNX export. GPU speeds measured with TensorRT export.
  Reproduce with yolo val segment data=coco.yaml batch=1 device=0|cpu

Consult the Classification Docs for usage examples. These models are trained on ImageNet, covering 1000 classes.

• acc values represent model accuracy on the ImageNet dataset validation set.
  Reproduce with yolo val classify data=path/to/ImageNet device=0
• Speed metrics are averaged over ImageNet val images using an Amazon EC2 P4d instance. CPU speeds measured with ONNX export. GPU speeds measured with TensorRT export.
  Reproduce with yolo val classify data=path/to/ImageNet batch=1 device=0|cpu

See the Pose Estimation Docs for usage examples. These models are trained on COCO-Pose, focusing on the 'person' class.

• mAP^val values are for single-model single-scale on the COCO Keypoints val2017 dataset. See YOLO Performance Metrics for details.
  Reproduce with yolo val pose data=coco-pose.yaml device=0
• Speed metrics are averaged over COCO val images using an Amazon EC2 P4d instance. CPU speeds measured with ONNX export. GPU speeds measured with TensorRT export.
  Reproduce with yolo val pose data=coco-pose.yaml batch=1 device=0|cpu

Check the OBB Docs for usage examples. These models are trained on DOTAv1, including 15 classes.

• mAP^test values are for single-model multiscale performance on the DOTAv1 test set.
  Reproduce by yolo val obb data=DOTAv1.yaml device=0 split=test and submit merged results to the DOTA evaluation server.
• Speed metrics are averaged over DOTAv1 val images using an Amazon EC2 P4d instance. CPU speeds measured with ONNX export. GPU speeds measured with TensorRT export.
  Reproduce by yolo val obb data=DOTAv1.yaml batch=1 device=0|cpu