Bắt đầu

Cách sử dụng Python

Hướng dẫn này trình bày cách tích hợp Ultralytics YOLO vào dự án Python để thực hiện phát hiện đối tượng, phân đoạn instance, phân đoạn ngữ nghĩa, ước lượng độ sâu, phân loại, ước lượng tư thế và phát hiện hộp giới hạn định hướng. Bạn sẽ học cách tải và sử dụng model pretrained, huấn luyện model mới và chạy dự đoán trên ảnh. Giao diện Python cho phép bạn thêm YOLO vào dự án chỉ với vài dòng mã.



Xem: Làm chủ Ultralytics YOLO: Python

Ví dụ: chỉ với vài dòng code, người dùng có thể tải model, huấn luyện model, đánh giá hiệu năng trên tập validation và thậm chí xuất model sang định dạng ONNX.

Python
from ultralytics import YOLO

# # Tạo model YOLO mới từ đầu
model = YOLO("yolo26n.yaml")

# # Tải model YOLO đã được huấn luyện trước (khuyến nghị khi huấn luyện)
model = YOLO("yolo26n.pt")

# # Huấn luyện model bằng dataset 'coco8.yaml' trong 3 epoch
results = model.train(data="coco8.yaml", epochs=3)

# # Đánh giá hiệu năng của model trên tập validation
results = model.val()

# # Thực hiện phát hiện đối tượng trên ảnh bằng model
results = model("https://ultralytics.com/images/bus.jpg")

# # Xuất model sang định dạng ONNX
success = model.export(format="onnx")

Huấn luyện#

Mode Train dùng để huấn luyện model YOLO trên dataset tùy chỉnh. Ở mode này, model được huấn luyện bằng dataset và hyperparameter đã chỉ định. Quá trình huấn luyện tối ưu hóa các tham số của model để model có thể dự đoán chính xác lớp và vị trí của đối tượng trong ảnh.

Huấn luyện
from ultralytics import YOLO

model = YOLO("yolo26n.pt")  # # truyền bất kỳ loại model nào
results = model.train(epochs=5)

Ví dụ huấn luyện

Đánh giá#

Mode Val dùng để xác thực model YOLO sau khi huấn luyện. Ở mode này, model được đánh giá trên tập validation nhằm đo lường độ chính xác và khả năng tổng quát hóa. Có thể dùng mode này để tinh chỉnh hyperparameter của model nhằm cải thiện hiệu năng.

Đánh giá
from ultralytics import YOLO

# Tải model YOLO
model = YOLO("yolo26n.yaml")

# Huấn luyện model
model.train(data="coco8.yaml", epochs=5)

# Đánh giá trên tập validation của dataset huấn luyện
model.val()

Ví dụ Val

Dự đoán#

Chế độ Predict được dùng để dự đoán trên hình ảnh hoặc video mới bằng model YOLO đã huấn luyện. Ở chế độ này, model được tải từ tệp checkpoint và người dùng có thể cung cấp hình ảnh hoặc video để chạy inference. Model dự đoán lớp và vị trí của các đối tượng trong hình ảnh hoặc video đầu vào.

Dự đoán
import cv2
from PIL import Image

from ultralytics import YOLO

model = YOLO("model.pt")
# chấp nhận mọi định dạng - image/dir/Path/URL/video/PIL/ndarray. 0 cho webcam
results = model.predict(source="folder", show=True)  # Hiển thị preds. Chấp nhận mọi đối số YOLO predict

# from PIL
im1 = Image.open("bus.jpg")
results = model.predict(source=im1, save=True)  # lưu hình ảnh đã vẽ

# từ ndarray
im2 = cv2.imread("bus.jpg")
results = model.predict(source=im2, save=True, save_txt=True)  # lưu dự đoán dưới dạng nhãn

# từ danh sách PIL/ndarray
results = model.predict(source=[im1, im2])

Ví dụ Predict

Export#

Chế độ Export được dùng để xuất model YOLO sang định dạng có thể triển khai. Ở chế độ này, model được chuyển đổi sang định dạng mà các ứng dụng phần mềm hoặc thiết bị phần cứng khác có thể sử dụng. Chế độ này hữu ích khi triển khai model trong môi trường production.

Export

Export model YOLO chính thức sang ONNX với batch size và kích thước ảnh động.

from ultralytics import YOLO

model = YOLO("yolo26n.pt")
model.export(format="onnx", dynamic=True)

Ví dụ Export

Theo dõi#

Mode Track dùng model YOLO để theo dõi đối tượng theo thời gian thực. Ở mode này, model được tải từ file checkpoint và người dùng có thể cung cấp luồng video trực tiếp để thực hiện theo dõi đối tượng theo thời gian thực. Mode này hữu ích cho các ứng dụng như hệ thống giám sát hoặc xe tự lái.

Theo dõi
from ultralytics import YOLO

# Tải model
model = YOLO("yolo26n.pt")  # tải model phát hiện chính thức
model = YOLO("yolo26n-seg.pt")  # tải model segmentation chính thức
model = YOLO("path/to/best.pt")  # tải model tùy chỉnh

# Theo dõi bằng model
results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True)
results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True, tracker="bytetrack.yaml")

Ví dụ Track

Benchmark#

Chế độ benchmark được dùng để lập hồ sơ tốc độ và độ chính xác của nhiều định dạng xuất khác nhau cho YOLO. Các benchmark cung cấp thông tin về kích thước của định dạng đã xuất, metric tác vụ (mAP50-95 cho phát hiện, phân đoạn, pose và OBB, mIoU cho phân đoạn ngữ nghĩa, δ1 cho ước tính độ sâu hoặc accuracy_top1 cho phân loại) và thời gian suy luận tính bằng mili giây trên mỗi ảnh ở nhiều định dạng xuất như ONNX, OpenVINO, TensorRT và các định dạng khác. Thông tin này có thể giúp người dùng chọn định dạng xuất tối ưu cho trường hợp sử dụng cụ thể dựa trên yêu cầu về tốc độ và độ chính xác.

Benchmark

Benchmark model YOLO chính thức trên tất cả định dạng export.

from ultralytics.utils.benchmarks import benchmark

# Benchmark
benchmark(model="yolo26n.pt", data="coco8.yaml", imgsz=640, device=0)

Ví dụ Benchmark

Sử dụng Trainer#

Lớp model YOLO đóng vai trò wrapper cấp cao cho các lớp Trainer. Mỗi tác vụ YOLO có Trainer riêng, kế thừa từ BaseTrainer. Kiến trúc này mang lại sự linh hoạt và khả năng tùy chỉnh cao hơn cho quy trình machine learning của bạn.

Ví dụ về Detection Trainer
from ultralytics.models.yolo.detect import DetectionPredictor, DetectionTrainer, DetectionValidator

overrides = {"model": "yolo26n.pt", "data": "coco8.yaml", "epochs": 3}

# Trainer
trainer = DetectionTrainer(overrides=overrides)
trainer.train()
trained_model = trainer.best  # đường dẫn đến best.pt

# Validator
validator = DetectionValidator(args={"data": "coco8.yaml"})
validator(model=trained_model)

# Predictor
predictor = DetectionPredictor(overrides={"model": trained_model})
predictor(source="https://ultralytics.com/images/bus.jpg")

# Tiếp tục quá trình huấn luyện bị gián đoạn từ checkpoint gần nhất
trainer = DetectionTrainer(overrides={"resume": "path/to/last.pt"})
trainer.train()

Bạn có thể tùy chỉnh Trainer để hỗ trợ tác vụ riêng hoặc thử nghiệm các ý tưởng nghiên cứu và phát triển. Thiết kế module của Ultralytics YOLO cho phép bạn điều chỉnh framework theo nhu cầu cụ thể, dù bạn đang phát triển một tác vụ thị giác máy tính mới hay fine-tune model hiện có để cải thiện hiệu năng.

Hướng dẫn tùy chỉnh

Câu hỏi thường gặp#

  • Việc tích hợp Ultralytics YOLO vào dự án Python rất đơn giản. Bạn có thể tải model pretrained hoặc huấn luyện model mới từ đầu. Sau đây là cách bắt đầu:

    from ultralytics import YOLO
    
    # Tải model YOLO pretrained
    model = YOLO("yolo26n.pt")
    
    # Thực hiện phát hiện đối tượng trên hình ảnh
    results = model("https://ultralytics.com/images/bus.jpg")
    
    # Trực quan hóa kết quả
    for result in results:
        result.show()

    Xem thêm ví dụ chi tiết trong phần Chế độ Predict.

  • Ultralytics YOLO cung cấp sáu mode cho các workflow machine learning khác nhau:

    • Train: Huấn luyện model bằng dataset tùy chỉnh.
    • Val: Đánh giá hiệu suất model trên tập validation.
    • Predict: Dự đoán trên hình ảnh hoặc luồng video mới.
    • Export: Xuất model sang nhiều định dạng như ONNX và TensorRT.
    • Track: Theo dõi đối tượng theo thời gian thực trong luồng video.
    • Benchmark: Đánh giá hiệu suất model trên các cấu hình khác nhau.

    Mỗi mode đảm nhiệm một giai đoạn khác nhau trong quá trình phát triển và triển khai model.

  • Để huấn luyện một model YOLO tùy chỉnh, hãy chỉ định dataset và các hyperparameter khác. Ví dụ nhanh:

    from ultralytics import YOLO
    
    # Tải model YOLO
    model = YOLO("yolo26n.yaml")
    
    # Huấn luyện model bằng dataset tùy chỉnh
    model.train(data="path/to/your/dataset.yaml", epochs=10)
  • Có thể dễ dàng export model YOLO sang định dạng phù hợp để triển khai bằng hàm export. Ví dụ: bạn có thể export model sang định dạng ONNX:

    from ultralytics import YOLO
    
    # Tải model YOLO
    model = YOLO("yolo26n.pt")
    
    # # Xuất model sang định dạng ONNX
    model.export(format="onnx")

    Để xem các tùy chọn export, hãy tham khảo tài liệu Chế độ Export.

  • Có. Sau khi huấn luyện, hãy truyền một YAML dataset khác cho val() để đánh giá model trên dataset đó:

    from ultralytics import YOLO
    
    # Tải model YOLO
    model = YOLO("yolo26n.yaml")
    
    # Huấn luyện model
    model.train(data="coco8.yaml", epochs=5)
    
    # Đánh giá model trên một dataset khác
    model.val(data="path/to/separate/data.yaml")

    Xem trang Chế độ Val để biết các ví dụ chi tiết và cách sử dụng.

Bình luận31

Đặt câu hỏi, chia sẻ kết quả hoặc giúp đỡ người khác.

  1. kindaichinisanGitHub

    How do I detect object using onnx model exported from pt model (yolo v9). Any sample code? Is it required to do pre-processing and post-processing?

    1. Glenn JocherUltralytics

      @kindaichinisan you can use ONNX models directly with Ultralytics for inference - no manual pre/post-processing needed:

      from ultralytics import YOLO
      
      # Load the ONNX model
      model = YOLO("your_model.onnx")
      
      # Run inference
      results = model("image.jpg")

      The Ultralytics framework handles all pre-processing and post-processing automatically when using ONNX models, just like with PT models.

  2. UltralyticsAssistantGitHubUltralytics

    👋 Hello, thank you for your interest in Ultralytics 🚀! We recommend checking out the Docs for new users, particularly the Python Usage guide you’ve linked, which contains detailed instructions on integrating YOLO for object detection, segmentation, and classification.

    If this is a 🐛 Bug Report, please provide a minimum reproducible example so we can assist you better.

    For custom training or ❓ questions, please include as much detail as possible, such as your Python script, dataset examples, training logs, or errors, and ensure you’re following our Tips for Best Training Results.

    Looking to connect with the Ultralytics community? Join us:

    • For real-time chat, visit Discord 🎧
    • For focused discussions, try Discourse
    • For general discussions and tips, explore our Subreddit

    Upgrade

    Ensure you’re running the latest version of the ultralytics package with all its requirements. Upgrade in a Python>=3.8 environment with PyTorch>=1.8 by running:

    pip install -U ultralytics

    Environments

    YOLO works seamlessly in any of the following verified environments (preloaded with dependencies like CUDA, Python, and PyTorch):

    Status

    Ultralytics CI

    If the badge above is green, our Ultralytics CI tests are passing. These tests are run daily and verify correct operation of all YOLO Modes and Tasks across macOS, Windows, and Ubuntu.

    This is an automated response to assist you quickly. An Ultralytics engineer will review your question and provide additional support shortly 😊

    1. dnnxlGitHub

      @dnnxl yes, YOLO11 supports augmentations during training, which are defined in the dataset configuration YAML file. You can customize augmentations such as flipping, scaling, and cropping to enhance model performance. For more details, refer to the Train Mode documentation. Let us know if you have further questions!

      Thanks for your answer, it works for object detection purposes right?

    2. Glenn JocherUltralytics

      Yes, augmentations in YOLO11 are fully supported for object detection tasks and can be applied during training to improve model generalization. Let us know if you need guidance on configuring them!

  3. Rain020GitHub

    Operating system: Win11, Ultralyicts: 8.3.27, YOLO11. I have developed a desktop application for PC-side processing. I need to release related GPU memory resources after closing the page or completing tasks. However, I haven’t found an effective way to release the memory to prevent GPU memory leaks. Looking forward to your response.

    1. Glenn JocherUltralytics

      @Rain020 to release GPU memory after completing tasks with YOLO11, you can try using PyTorch's torch.cuda.empty_cache() function to clear unused cached memory. Additionally, ensure that all model and variable references are deleted and use del to remove them before calling the cache clearing function. If issues persist, consider checking for any persistent references that might still occupy memory. For more details, refer to the PyTorch documentation.

    2. Rain020GitHub

      Thank you for your response. I need to conduct some experiments to verify whether our solution is effective.

  4. Sheepy1977GitHub

    There are some translation-mistakes in Chinese "Train" should be "训练",not “火车” "Val" should be "校验",not "瓦尔" "Track“ should be "跟踪“,not "轨道"

    1. Paula DerrengerUltralytics

      @Sheepy1977 thank you for pointing out the translation errors. We appreciate your attention to detail. We will update the translations as follows:

      • "Train" will be corrected to "训练"
      • "Val" will be corrected to "校验"
      • "Track" will be corrected to "跟踪"

      Your feedback helps us improve the documentation for all users. If you notice any other issues, please let us know.

  5. yirenyixinGitHub

    Hello, when I was training with the dataset, I found that all the label names I gave were changed to class_X after training. The following is the configuration of my ymal file: path: E:\BaiduNetdiskDownload\Citypersons train: images/train val: images/train nc: 1 name: 0: person

    After training, use the model to recognize others. The label information displays class_0

    1. Glenn JocherUltralytics

      Hello! It seems like the class names are defaulting to class_X because the model might not be recognizing the class names specified in your YAML file. This can sometimes happen if there's an issue with the formatting of the YAML file or how the classes are being read during training.

      To ensure your class names are recognized correctly, please make sure your YAML file is formatted correctly. Here's a corrected version of your YAML configuration:

      path: E:\BaiduNetdiskDownload\Citypersons
      train: images/train
      val: images/train
      nc: 1
      names:
        - person

      Notice the change from name: to names: and ensuring that the class names are listed with a dash -. This should help the model recognize and use the correct class names during training and inference.

      If the issue persists after this adjustment, please double-check the path and file names for typos and ensure that the dataset is being loaded correctly during training. If you need further assistance, feel free to ask! 😊

  6. flyingship19820207GitHub

    The code is simple, for it is the same with your sample:

    from ultralytics import YOLO

    Create a new YOLO model from scratch

    model = YOLO('yolov8n.yaml')

    model = YOLO('yolov8n.pt')

    Train the model using the 'coco128.yaml' dataset for 3 epochs

    results = model.train(data='coco128.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')

    Below is the error details: Traceback (most recent call last): File "/usr/local/lib/python3.11/site-packages/ultralytics/engine/trainer.py", line 133, in init self.data = check_det_dataset(self.args.data) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/site-packages/ultralytics/data/utils.py", line 271, in check_det_dataset if zipfile.is_zipfile(file) or is_tarfile(file): ^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/tarfile.py", line 2791, in is_tarfile t = open(name) ^^^^^^^^^^ File "/usr/local/lib/python3.11/tarfile.py", line 1804, in open return func(name, "r", fileobj, **kwargs) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/tarfile.py", line 1933, in xzopen t = cls.taropen(name, mode, fileobj, **kwargs) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/tarfile.py", line 1854, in taropen return cls(name, mode, fileobj, **kwargs) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/tarfile.py", line 1714, in init self.firstmember = self.next() ^^^^^^^^^^^ File "/usr/local/lib/python3.11/tarfile.py", line 2631, in next raise e File "/usr/local/lib/python3.11/tarfile.py", line 2604, in next tarinfo = self.tarinfo.fromtarfile(self) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/tarfile.py", line 1292, in fromtarfile buf = tarfile.fileobj.read(BLOCKSIZE) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/lzma.py", line 207, in read return self._buffer.read(size) ^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/_compression.py", line 68, in readinto data = self.read(len(byte_view)) ^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/_compression.py", line 96, in read if self._decompressor.needs_input: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ AttributeError: '_lzma.LZMADecompressor' object has no attribute 'needs_input'

    The above exception was the direct cause of the following exception:

    Traceback (most recent call last): File "/root/chenyong/1_yolo/1_test/yolo_test.py", line 10, in results = model.train(data='coco128.yaml', epochs=3) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/site-packages/ultralytics/engine/model.py", line 635, in train self.trainer = (trainer or self._smart_load("trainer"))(overrides=args, _callbacks=self.callbacks) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/local/lib/python3.11/site-packages/ultralytics/engine/trainer.py", line 137, in init raise RuntimeError(emojis(f"Dataset '{clean_url(self.args.data)}' error ❌ {e}")) from e RuntimeError: Dataset 'coco128.yaml' error ❌ '_lzma.LZMADecompressor' object has no attribute 'needs_input'

    1. Paula DerrengerUltralytics

      It seems like you're encountering an issue related to the LZMA compression library, specifically with the _lzma.LZMADecompressor object. This could be due to a variety of reasons, including compatibility issues with the Python version you're using or the specific dataset file format.

      As a first step, I recommend ensuring that your Python environment is up-to-date and that you're using a compatible version of the Ultralytics YOLO package. Additionally, verifying the integrity and format of the coco128.yaml dataset file might help, as the error suggests there could be an issue with reading the dataset file.

      If you're still facing this issue after checking these points, could you please provide more details about your environment, such as the Python and Ultralytics YOLO versions? This information will help us better understand the problem and assist you more effectively. 🛠️

      In the meantime, here's a quick check you can perform to ensure your dataset file is accessible and correctly formatted:

      import yaml
      
      # Attempt to load the YAML file to check its integrity
      with open('coco128.yaml', 'r') as file:
          dataset = yaml.safe_load(file)
          print(dataset)

      This code snippet will try to load your coco128.yaml file and print its contents, which can help identify if there are any issues with the file itself.

    2. flyingship19820207GitHub

      Thanks for your reply. I copy coco128.yaml from /usr/local/lib/python3.11/site-packages/ultralytics/cfg/datasets/coco128.yaml to current work dir.And run the code you provided: import yaml

      Attempt to load the YAML file to check its integrity

      with open('coco128.yaml', 'r') as file: dataset = yaml.safe_load(file) print(dataset) The result is as below: {'path': '../datasets/coco128', 'train': 'images/train2017', 'val': 'images/train2017', 'test': None, 'names': {0: 'person', 1: 'bicycle', 2: 'car', 3: 'motorcycle', 4: 'airplane', 5: 'bus', 6: 'train', 7: 'truck', 8: 'boat', 9: 'traffic light', 10: 'fire hydrant', 11: 'stop sign', 12: 'parking meter', 13: 'bench', 14: 'bird', 15: 'cat', 16: 'dog', 17: 'horse', 18: 'sheep', 19: 'cow', 20: 'elephant', 21: 'bear', 22: 'zebra', 23: 'giraffe', 24: 'backpack', 25: 'umbrella', 26: 'handbag', 27: 'tie', 28: 'suitcase', 29: 'frisbee', 30: 'skis', 31: 'snowboard', 32: 'sports ball', 33: 'kite', 34: 'baseball bat', 35: 'baseball glove', 36: 'skateboard', 37: 'surfboard', 38: 'tennis racket', 39: 'bottle', 40: 'wine glass', 41: 'cup', 42: 'fork', 43: 'knife', 44: 'spoon', 45: 'bowl', 46: 'banana', 47: 'apple', 48: 'sandwich', 49: 'orange', 50: 'broccoli', 51: 'carrot', 52: 'hot dog', 53: 'pizza', 54: 'donut', 55: 'cake', 56: 'chair', 57: 'couch', 58: 'potted plant', 59: 'bed', 60: 'dining table', 61: 'toilet', 62: 'tv', 63: 'laptop', 64: 'mouse', 65: 'remote', 66: 'keyboard', 67: 'cell phone', 68: 'microwave', 69: 'oven', 70: 'toaster', 71: 'sink', 72: 'refrigerator', 73: 'book', 74: 'clock', 75: 'vase', 76: 'scissors', 77: 'teddy bear', 78: 'hair drier', 79: 'toothbrush'}, 'download': 'https://ultralytics.com/assets/coco128.zip'}

    3. Paula DerrengerUltralytics(đã chỉnh sửa)

      @flyingship19820207 hey there! Thanks for reaching out with your environment details. It looks like you're using Python 3.11.7 and YOLOv8 version 8.1.24, which should be compatible.

      Given the error you encountered, it seems like there might be an issue with the LZMA library in Python 3.11.7 or how the dataset is being processed. As a quick workaround, you might want to try running your code in a virtual environment with an earlier version of Python (e.g., Python 3.8 or 3.9) to see if the issue persists. This can help isolate whether it's a Python version-specific issue.

      Here's a quick guide on setting up a virtual environment:

      # Create a virtual environment with Python 3.8 (needs to be installed already)
      python3.8 -m venv yolov8-env
      
      # Activate the virtual environment
      source yolov8-env/bin/activate
      
      # Install Ultralytics YOLO
      pip install ultralytics

      After setting up and activating your virtual environment, try running your YOLOv8 code again. If the problem is resolved, it might be worth reporting this as a compatibility issue with Python 3.11.7 on the Ultralytics GitHub page for further investigation. 🕵️‍♂️

      Let me know how it goes!

    4. flyingship19820207GitHub

      I have tried python3.10 which system-provided by ubuntu 22.4,it works well.It seems the error is caused by many python version in one system.

    5. Paula DerrengerUltralytics

      Hey there! 🎉 It's great to hear that switching to Python 3.10 resolved the issue for you. It seems like the problem was indeed related to having multiple Python versions in your system. This can sometimes lead to conflicts, especially with dependencies and libraries that are sensitive to the Python version.

      For future reference, it's always a good idea to use virtual environments for each project. This way, you can manage dependencies more effectively and avoid version conflicts. Here's a quick way to set up a virtual environment for your projects:

      python3 -m venv myenv
      source myenv/bin/activate

      And then, you can install the specific packages you need within this isolated environment.

      If you have any more questions or run into further issues, feel free to reach out. Happy coding with YOLOv8! 🚀

  7. flyingship19820207GitHub

    there is an error while trying to train yolo8 :RuntimeError: Dataset 'coco8.yaml' error ❌ '_lzma.LZMADecompressor' object has no attribute 'needs_input'.I use python3.11 and the system is ubuntu.How to fix it.

    1. Paula DerrengerUltralytics

      Hey there! 👋 It seems like you're encountering an issue related to the _lzma module while training YOLOv8 with Python 3.11 on Ubuntu. This could be due to a compatibility issue with the LZMA library in Python 3.11.

      A quick workaround could be to try downgrading to Python 3.8 or 3.9, as these versions are known to work well with YOLOv8 and its dependencies. You can manage multiple Python versions using a tool like pyenv.

      Here's how you can install and use pyenv to switch to Python 3.8:

      # Install pyenv
      curl https://pyenv.run | bash
      
      # Add pyenv to path (you might want to add this to your .bashrc or .zshrc)
      export PATH="$HOME/.pyenv/bin:$PATH"
      eval "$(pyenv init --path)"
      eval "$(pyenv virtualenv-init -)"
      
      # Install Python 3.8
      pyenv install 3.8.10
      
      # Set the local (current directory) Python version to 3.8.10
      pyenv local 3.8.10
      
      # Verify the Python version
      python --version

      After switching to Python 3.8, try running your training command again. If the issue persists or you have any more questions, feel free to reach out! 😊

    2. flyingship19820207GitHub

      I comment these code below: #if zipfile.is_zipfile(file) or is_tarfile(file):

      new_dir = safe_download(file, dir=DATASETS_DIR, unzip=True, delete=False)

      file = find_dataset_yaml(DATASETS_DIR / new_dir)

      extract_dir, autodownload = file.parent, False

      in file /usr/local/lib/python3.11/site-packages/ultralytics/data/utils.py,then run again, it seems works.

    3. Paula DerrengerUltralytics(đã chỉnh sửa)

      Hey there! 👋 It looks like you've found a workaround by commenting out some code related to dataset extraction in utils.py. While this might work temporarily, it's generally not recommended to modify library code directly, as it could lead to unexpected behavior or issues with future updates.

      The error you encountered seems related to the _lzma module in Python 3.11. This could be a compatibility issue with the Python version and the LZMA library. A safer approach might be to ensure all your dependencies are correctly installed and compatible with Python 3.11. You could try reinstalling the lzma module or using a Python environment with a version known to work well with YOLOv8, such as Python 3.8 or 3.9.

      If you're set on using Python 3.11, you might also want to check if there's an open issue on the Ultralytics YOLOv8 GitHub repository regarding this, or consider opening a new issue to bring this to the developers' attention. They might offer a more permanent fix or advice on handling this compatibility issue.

      In the meantime, if you need to keep working, using a virtual environment with a different Python version could be a quick fix:

      # Create a virtual environment with Python 3.8
      python3.8 -m venv yolov8-env
      
      # Activate the virtual environment
      source yolov8-env/bin/activate
      
      # Install YOLOv8 and other dependencies
      pip install ultralytics

      Hope this helps, and happy coding! 😊