ابدأ

استخدام Python

يوضح هذا الدليل كيفية دمج Ultralytics YOLO في مشاريع Python لمهام كشف الأجسام، وتقسيم المثيلات، والتقسيم الدلالي، وتقدير العمق، والتصنيف، وتقدير الوضعية، وكشف مربعات الإحاطة الموجّهة. ستتعلم كيفية تحميل النماذج المدرّبة مسبقًا واستخدامها، وتدريب نماذج جديدة، وإجراء تنبؤات على الصور. تتيح لك واجهة Python إضافة YOLO إلى مشروعك باستخدام بضعة أسطر من الشيفرة فقط.



شاهد: إتقان Ultralytics YOLO: Python

على سبيل المثال، يمكن للمستخدمين تحميل نموذج وتدريبه وتقييم أدائه على مجموعة تحقق، بل وتصديره إلى تنسيق ONNX، وذلك باستخدام بضعة أسطر من التعليمات البرمجية.

Python
from ultralytics import YOLO

# ⁨إنشاء نموذج YOLO جديد من البداية⁩
model = YOLO("yolo26n.yaml")

# ⁨تحميل نموذج YOLO مدرّب مسبقًا (موصى به للتدريب)⁩
model = YOLO("yolo26n.pt")

# ⁨تدريب النموذج باستخدام مجموعة البيانات 'coco8.yaml' لمدة 3 عصور⁩
results = model.train(data="coco8.yaml", epochs=3)

# ⁨تقييم أداء النموذج على مجموعة التحقق⁩
results = model.val()

# ⁨إجراء كشف الكائنات في صورة باستخدام النموذج⁩
results = model("https://ultralytics.com/images/bus.jpg")

# ⁨تصدير النموذج إلى تنسيق ONNX⁩
success = model.export(format="onnx")

التدريب#

يُستخدم وضع التدريب لتدريب نموذج YOLO على مجموعة بيانات مخصصة. في هذا الوضع، يُدرّب النموذج باستخدام مجموعة البيانات والمعلمات الفائقة المحددة. تتضمن عملية التدريب تحسين معلمات النموذج ليتمكن من التنبؤ بدقة بفئات الأجسام ومواقعها في الصورة.

التدريب
from ultralytics import YOLO

model = YOLO("yolo26n.pt")  # ⁨مرّر أي نوع من النماذج⁩
results = model.train(epochs=5)

أمثلة التدريب

التحقق#

يُستخدم وضع التحقق للتحقق من صحة نموذج YOLO بعد تدريبه. في هذا الوضع، يُقيّم النموذج على مجموعة التحقق لقياس دقته وأداء التعميم. ويمكن استخدام هذا الوضع لضبط المعلمات الفائقة للنموذج وتحسين أدائه.

التحقق
from ultralytics import YOLO

# ⁨تحميل نموذج YOLO⁩
model = YOLO("yolo26n.yaml")

# ⁨تدريب النموذج⁩
model.train(data="coco8.yaml", epochs=5)

# ⁨التحقق باستخدام جزء التحقق من مجموعة بيانات التدريب⁩
model.val()

أمثلة التحقق

التنبؤ#

يُستخدم وضع التنبؤ لإجراء تنبؤات باستخدام نموذج YOLO مدرَّب على صور أو مقاطع فيديو جديدة. في هذا الوضع، يُحمَّل النموذج من ملف نقطة تحقق، ويمكن للمستخدم تقديم صور أو مقاطع فيديو لإجراء الاستدلال. ويتنبأ النموذج بفئات الكائنات ومواقعها في الصور أو مقاطع الفيديو المُدخلة.

التنبؤ
import cv2
from PIL import Image

from ultralytics import YOLO

model = YOLO("model.pt")
# ⁨يقبل جميع التنسيقات - image/dir/Path/URL/video/PIL/ndarray. 0 لكاميرا الويب⁩
results = model.predict(source="folder", show=True)  # ⁨عرض preds. يقبل جميع وسيطات تنبؤ YOLO⁩

# from PIL
im1 = Image.open("bus.jpg")
results = model.predict(source=im1, save=True)  # ⁨حفظ الصور المرسومة⁩

# from ndarray
im2 = cv2.imread("bus.jpg")
results = model.predict(source=im2, save=True, save_txt=True)  # ⁨حفظ التنبؤات كوسوم⁩

# ⁨من قائمة تضم PIL/ndarray⁩
results = model.predict(source=[im1, im2])

أمثلة التنبؤ

التصدير#

يُستخدم وضع التصدير لتصدير نموذج YOLO إلى تنسيق مناسب للنشر. في هذا الوضع، يُحوَّل النموذج إلى تنسيق يمكن أن تستخدمه تطبيقات برمجية أو أجهزة عتادية أخرى. ويفيد هذا الوضع عند نشر النموذج في بيئات الإنتاج.

التصدير

صدّر نموذج YOLO رسميًا إلى ONNX باستخدام حجم دفعة وحجم صورة ديناميكيين.

from ultralytics import YOLO

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

أمثلة التصدير

التتبّع#

يُستخدم وضع التتبع لتتبع الأجسام آنيًا باستخدام نموذج YOLO. في هذا الوضع، يُحمّل النموذج من ملف نقطة تحقق، ويمكن للمستخدم توفير بث فيديو مباشر لإجراء تتبع الأجسام آنيًا. يفيد هذا الوضع في تطبيقات مثل أنظمة المراقبة أو السيارات ذاتية القيادة.

التتبّع
from ultralytics import YOLO

# ⁨تحميل نموذج⁩
model = YOLO("yolo26n.pt")  # ⁨تحميل نموذج كشف رسمي⁩
model = YOLO("yolo26n-seg.pt")  # ⁨تحميل نموذج تجزئة رسمي⁩
model = YOLO("path/to/best.pt")  # ⁨تحميل نموذج مخصص⁩

# ⁨التتبّع باستخدام النموذج⁩
results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True)
results = model.track(source="https://youtu.be/LNwODJXcvt4", show=True, tracker="bytetrack.yaml")

أمثلة التتبّع

قياس الأداء#

يُستخدم وضع قياس الأداء لتحديد سرعة ودقة تنسيقات التصدير المختلفة لـ YOLO. توفر معايير الأداء معلومات عن حجم التنسيق المُصدَّر، ومقياس المهمة الخاص به (mAP50-95 للكشف والتجزئة وتقدير الوضعية وOBB، أو mIoU للتجزئة الدلالية، أو δ1 لتقدير العمق، أو accuracy_top1 للتصنيف)، وزمن الاستدلال بالمللي ثانية لكل صورة عبر تنسيقات تصدير مختلفة مثل ONNX وOpenVINO وTensorRT وغيرها. تساعد هذه المعلومات المستخدمين على اختيار تنسيق التصدير الأمثل لحالة الاستخدام المحددة، استنادًا إلى متطلباتهم المتعلقة بالسرعة والدقة.

قياس الأداء

قياس أداء نموذج YOLO رسمي عبر جميع تنسيقات التصدير.

from ultralytics.utils.benchmarks import benchmark

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

أمثلة قياس الأداء

استخدام المدربين#

يعمل صنف النموذج YOLO كغلاف عالي المستوى لأصناف Trainer. ولكل مهمة YOLO مدرّبها الخاص الذي يرث من BaseTrainer. وتتيح هذه البنية مزيدًا من المرونة والتخصيص في سير عمل التعلم الآلي.

مثال على مدرّب الكشف
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  # ⁨مسار 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")

# ⁨استئناف تشغيل تدريب متوقف من آخر نقطة تحقق له⁩
trainer = DetectionTrainer(overrides={"resume": "path/to/last.pt"})
trainer.train()

يمكنك تخصيص أدوات التدريب لدعم مهام مخصصة أو استكشاف أفكار البحث والتطوير. يتيح التصميم المعياري لـ Ultralytics YOLO تكييف إطار العمل مع احتياجاتك المحددة، سواء أكنت تعمل على مهمة جديدة في الرؤية الحاسوبية أم تضبط النماذج الحالية بدقة لتحسين الأداء.

دروس التخصيص

الأسئلة الشائعة#

  • إن دمج Ultralytics YOLO في مشاريع Python الخاصة بك أمر بسيط. يمكنك تحميل نموذج مدرَّب مسبقًا أو تدريب نموذج جديد من الصفر. إليك كيفية البدء:

    from ultralytics import YOLO
    
    # ⁨تحميل نموذج YOLO مدرَّب مسبقًا⁩
    model = YOLO("yolo26n.pt")
    
    # ⁨إجراء كشف الكائنات في صورة⁩
    results = model("https://ultralytics.com/images/bus.jpg")
    
    # ⁨تصوّر النتائج⁩
    for result in results:
        result.show()

    اطّلع على مزيد من الأمثلة المفصلة في قسم وضع التنبؤ.

  • يوفر Ultralytics YOLO ستة أوضاع لسير عمل التعلم الآلي المختلفة:

    • التدريب: تدريب نموذج باستخدام مجموعات بيانات مخصصة.
    • التحقق: التحقق من أداء النموذج باستخدام مجموعة تحقق.
    • التنبؤ: إجراء تنبؤات على صور جديدة أو تدفقات فيديو.
    • التصدير: تصدير النماذج إلى تنسيقات مختلفة مثل ONNX وTensorRT.
    • التتبّع: تتبّع الكائنات في تدفقات الفيديو في الوقت الفعلي.
    • قياس الأداء: قياس أداء النموذج عبر إعدادات مختلفة.

    يغطي كل وضع مرحلة مختلفة من تطوير النماذج ونشرها.

  • لـتدريب نموذج YOLO مخصص، حدّد مجموعة بياناتك وأي معلمات فائقة أخرى. إليك مثالًا سريعًا:

    from ultralytics import YOLO
    
    # ⁨تحميل نموذج YOLO⁩
    model = YOLO("yolo26n.yaml")
    
    # ⁨تدريب النموذج باستخدام مجموعة بيانات مخصصة⁩
    model.train(data="path/to/your/dataset.yaml", epochs=10)
  • من السهل تصدير نماذج YOLO بتنسيق مناسب للنشر باستخدام الدالة export. على سبيل المثال، يمكنك تصدير نموذج إلى تنسيق ONNX:

    from ultralytics import YOLO
    
    # ⁨تحميل نموذج YOLO⁩
    model = YOLO("yolo26n.pt")
    
    # ⁨تصدير النموذج إلى تنسيق ONNX⁩
    model.export(format="onnx")

    للاطّلاع على خيارات التصدير المختلفة، راجع وثائق وضع التصدير.

  • نعم. بعد التدريب، مرّر ملف YAML لمجموعة بيانات مختلفة إلى val() لتقييم النموذج عليها:

    from ultralytics import YOLO
    
    # ⁨تحميل نموذج YOLO⁩
    model = YOLO("yolo26n.yaml")
    
    # ⁨تدريب النموذج⁩
    model.train(data="coco8.yaml", epochs=5)
    
    # ⁨التحقق من النموذج باستخدام مجموعة بيانات مختلفة⁩
    model.val(data="path/to/separate/data.yaml")

    راجع صفحة وضع التحقق للاطّلاع على أمثلة مفصلة وطريقة الاستخدام.

التعليقات31

اطرح سؤالًا، وشارك نتائجك، أو ساعد شخصًا آخر.

  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(تم التعديل)

      @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(تم التعديل)

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