ultralytics/docs/en/help/FAQ.md

comments	description	keywords
true	Explore common questions and solutions related to Ultralytics YOLO, from hardware requirements to model fine-tuning and real-time detection.	Ultralytics, YOLO, FAQ, object detection, hardware requirements, fine-tuning, ONNX, TensorFlow, real-time detection, model accuracy

Ultralytics YOLO Frequently Asked Questions (FAQ)

This FAQ section addresses common questions and issues users might encounter while working with Ultralytics YOLO repositories.

FAQ

What is Ultralytics and what does it offer?

Ultralytics is a computer vision AI company specializing in state-of-the-art object detection and image segmentation models, with a focus on the YOLO (You Only Look Once) family. Their offerings include:

• Open-source implementations of YOLOv8 and YOLO11
• A wide range of pre-trained models for various computer vision tasks
• A comprehensive Python package for seamless integration of YOLO models into projects
• Versatile tools for training, testing, and deploying models
• Extensive documentation and a supportive community

How do I install the Ultralytics package?

Installing the Ultralytics package is straightforward using pip:

pip install ultralytics

For the latest development version, install directly from the GitHub repository:

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

Detailed installation instructions can be found in the quickstart guide.

What are the system requirements for running Ultralytics models?

Minimum requirements:

• Python 3.8+
• PyTorch 1.8+
• CUDA-compatible GPU (for GPU acceleration)

Recommended setup:

• Python 3.8+
• PyTorch 1.10+
• NVIDIA GPU with CUDA 11.2+
• 8GB+ RAM
• 50GB+ free disk space (for dataset storage and model training)

For troubleshooting common issues, visit the YOLO Common Issues page.

How can I train a custom YOLO model on my own dataset?

To train a custom YOLO model:

1. Prepare your dataset in YOLO format (images and corresponding label txt files).

2. Create a YAML file describing your dataset structure and classes.

3. Use the following Python code to start training:

   from ultralytics import YOLO
   
   # Load a model
   model = YOLO("yolov8n.yaml")  # build a new model from scratch
   model = YOLO("yolov8n.pt")  # load a pretrained model (recommended for training)
   
   # Train the model
   results = model.train(data="path/to/your/data.yaml", epochs=100, imgsz=640)
   

For a more in-depth guide, including data preparation and advanced training options, refer to the comprehensive training guide.

What pretrained models are available in Ultralytics?

Ultralytics offers a diverse range of pretrained models for various tasks:

• Object Detection: YOLO11n, YOLO11s, YOLO11m, YOLO11l, YOLO11x
• Instance Segmentation: YOLO11n-seg, YOLO11s-seg, YOLO11m-seg, YOLO11l-seg, YOLO11x-seg
• Classification: YOLO11n-cls, YOLO11s-cls, YOLO11m-cls, YOLO11l-cls, YOLO11x-cls
• Pose Estimation: YOLO11n-pose, YOLO11s-pose, YOLO11m-pose, YOLO11l-pose, YOLO11x-pose

These models vary in size and complexity, offering different trade-offs between speed and accuracy. Explore the full range of pretrained models to find the best fit for your project.

How do I perform inference using a trained Ultralytics model?

To perform inference with a trained model:

from ultralytics import YOLO

# Load a model
model = YOLO("path/to/your/model.pt")

# Perform inference
results = model("path/to/image.jpg")

# Process results
for r in results:
    print(r.boxes)  # print bbox predictions
    print(r.masks)  # print mask predictions
    print(r.probs)  # print class probabilities

For advanced inference options, including batch processing and video inference, check out the detailed prediction guide.

Can Ultralytics models be deployed on edge devices or in production environments?

Absolutely! Ultralytics models are designed for versatile deployment across various platforms:

• Edge devices: Optimize inference on devices like NVIDIA Jetson or Intel Neural Compute Stick using TensorRT, ONNX, or OpenVINO.
• Mobile: Deploy on Android or iOS devices by converting models to TFLite or Core ML.
• Cloud: Leverage frameworks like TensorFlow Serving or PyTorch Serve for scalable cloud deployments.
• Web: Implement in-browser inference using ONNX.js or TensorFlow.js.

Ultralytics provides export functions to convert models to various formats for deployment. Explore the wide range of deployment options to find the best solution for your use case.

What's the difference between YOLOv8 and YOLO11?

Key distinctions include:

• Architecture: YOLO11 features an improved backbone and head design for enhanced performance.
• Performance: YOLO11 generally offers superior accuracy and speed compared to YOLOv8.
• Efficiency: YOLO11m achieves higher mean Average Precision (mAP) on the COCO dataset with 22% fewer parameters than YOLOv8m.
• Tasks: Both models support object detection, instance segmentation, classification, and pose estimation in a unified framework.
• Codebase: YOLO11 is implemented with a more modular and extensible architecture, facilitating easier customization and extension.

For an in-depth comparison of features and performance metrics, visit the YOLO11 documentation page.

How can I contribute to the Ultralytics open-source project?

Contributing to Ultralytics is a great way to improve the project and expand your skills. Here's how you can get involved:

1. Fork the Ultralytics repository on GitHub.
2. Create a new branch for your feature or bug fix.
3. Make your changes and ensure all tests pass.
4. Submit a pull request with a clear description of your changes.
5. Participate in the code review process.

You can also contribute by reporting bugs, suggesting features, or improving documentation. For detailed guidelines and best practices, refer to the contributing guide.

How do I install the Ultralytics package in Python?

Installing the Ultralytics package in Python is simple. Use pip by running the following command in your terminal or command prompt:

pip install ultralytics

For the cutting-edge development version, install directly from the GitHub repository:

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

For environment-specific installation instructions and troubleshooting tips, consult the comprehensive quickstart guide.

What are the main features of Ultralytics YOLO?

Ultralytics YOLO boasts a rich set of features for advanced computer vision tasks:

• Real-Time Detection: Efficiently detect and classify objects in real-time scenarios.
• Multi-Task Capabilities: Perform object detection, instance segmentation, classification, and pose estimation with a unified framework.
• Pre-Trained Models: Access a variety of pretrained models that balance speed and accuracy for different use cases.
• Custom Training: Easily fine-tune models on custom datasets with the flexible training pipeline.
• Wide Deployment Options: Export models to various formats like TensorRT, ONNX, and CoreML for deployment across different platforms.
• Extensive Documentation: Benefit from comprehensive documentation and a supportive community to guide you through your computer vision journey.

How can I improve the performance of my YOLO model?

Enhancing your YOLO model's performance can be achieved through several techniques:

1. Hyperparameter Tuning: Experiment with different hyperparameters using the Hyperparameter Tuning Guide to optimize model performance.
2. Data Augmentation: Implement techniques like flip, scale, rotate, and color adjustments to enhance your training dataset and improve model generalization.
3. Transfer Learning: Leverage pre-trained models and fine-tune them on your specific dataset using the Train guide.
4. Export to Efficient Formats: Convert your model to optimized formats like TensorRT or ONNX for faster inference using the Export guide.
5. Benchmarking: Utilize the Benchmark Mode to measure and improve inference speed and accuracy systematically.

Can I deploy Ultralytics YOLO models on mobile and edge devices?

Yes, Ultralytics YOLO models are designed for versatile deployment, including mobile and edge devices:

• Mobile: Convert models to TFLite or CoreML for seamless integration into Android or iOS apps. Refer to the TFLite Integration Guide and CoreML Integration Guide for platform-specific instructions.
• Edge Devices: Optimize inference on devices like NVIDIA Jetson or other edge hardware using TensorRT or ONNX. The Edge TPU Integration Guide provides detailed steps for edge deployment.

For a comprehensive overview of deployment strategies across various platforms, consult the deployment options guide.

How can I perform inference using a trained Ultralytics YOLO model?

Performing inference with a trained Ultralytics YOLO model is straightforward:

1. Load the Model:

   from ultralytics import YOLO
   
   model = YOLO("path/to/your/model.pt")
   

2. Run Inference:

   results = model("path/to/image.jpg")
   
   for r in results:
       print(r.boxes)  # print bounding box predictions
       print(r.masks)  # print mask predictions
       print(r.probs)  # print class probabilities
   

For advanced inference techniques, including batch processing, video inference, and custom preprocessing, refer to the detailed prediction guide.

Where can I find examples and tutorials for using Ultralytics?

Ultralytics provides a wealth of resources to help you get started and master their tools:

• 📚 Official documentation: Comprehensive guides, API references, and best practices.
• 💻 GitHub repository: Source code, example scripts, and community contributions.
• ✍️ Ultralytics blog: In-depth articles, use cases, and technical insights.
• 💬 Community forums: Connect with other users, ask questions, and share your experiences.
• 🎥 YouTube channel: Video tutorials, demos, and webinars on various Ultralytics topics.

These resources provide code examples, real-world use cases, and step-by-step guides for various tasks using Ultralytics models.

If you need further assistance, don't hesitate to consult the Ultralytics documentation or reach out to the community through GitHub Issues or the official discussion forum.