Часто задаваемые вопросы (FAQ) об Ultralytics YOLO
В этом разделе часто задаваемых вопросов собраны ответы на распространённые вопросы и решения проблем, с которыми пользователи могут столкнуться при работе с репозиториями Ultralytics YOLO.
Часто задаваемые вопросы#
Ultralytics — компания в сфере ИИ и компьютерного зрения, специализирующаяся на передовых моделях обнаружения объектов и сегментации изображений, в первую очередь семейства YOLO (смотришь только один раз). Среди наших продуктов:
- Реализации с открытым исходным кодом для YOLO26 (последнее поколение) и YOLO11 (предыдущее поколение)
- Широкий выбор предварительно обученных моделей для различных задач компьютерного зрения
- Полноценный пакет Python для интеграции моделей YOLO в проекты
- Универсальные инструменты для обучения, тестирования и развертывания моделей
- Ultralytics Platform для разметки данных, обучения моделей в облаке и их развёртывания
- Подробная документация и отзывчивое сообщество
Нет. YOLO27 проходит заключительный этап исследований и разработок (R&D); ожидается, что запуск состоится позже в этом году, но конкретная дата пока не назначена. В документации представлены предварительные сведения о функциях модели, предварительные результаты тестирования и примеры использования после выпуска. Для текущих проектов продолжай использовать YOLO26.
Установить пакет Ultralytics с помощью pip просто:
pip install ultralyticsЧтобы установить последнюю версию для разработки, выполни установку непосредственно из репозитория GitHub:
pip install git+https://github.com/ultralytics/ultralytics.gitПодробные инструкции по установке приведены в кратком руководстве.
Минимальные требования:
- Python 3.8+
- PyTorch 1.8+
- GPU, совместимый с CUDA (для ускорения на GPU)
Рекомендуемая конфигурация:
- GPU NVIDIA
- ОЗУ: 8 ГБ и более
- Не менее 50 ГБ свободного места на диске (для хранения наборов данных и обучения моделей)
Решения распространённых проблем смотри на странице «Распространённые проблемы YOLO».
Чтобы обучить собственную модель YOLO:
-
Подготовь набор данных в формате YOLO: изображения и соответствующие файлы меток с расширением txt.
-
Создай файл YAML с описанием структуры набора данных и классов (см. пример YAML-файла набора данных).
-
Чтобы начать обучение, используй следующий код на Python:
from ultralytics import YOLO # Загрузить модель model = YOLO("yolo26n.yaml") # создать новую модель с нуля model = YOLO("yolo26n.pt") # загрузить предварительно обученную модель (рекомендуется для обучения) # Обучить модель results = model.train(data="path/to/your/data.yaml", epochs=100, imgsz=640)
Подробное руководство, в котором рассматриваются подготовка данных и расширенные параметры обучения, смотри в руководстве по обучению.
-
Ultralytics предлагает широкий выбор предварительно обученных моделей YOLO26 для различных задач:
- Обнаружение объектов: YOLO26n, YOLO26s, YOLO26m, YOLO26l, YOLO26x
- Сегментация экземпляров: YOLO26n-seg, YOLO26s-seg, YOLO26m-seg, YOLO26l-seg, YOLO26x-seg
- Семантическая сегментация: YOLO26n-sem, YOLO26s-sem, YOLO26m-sem, YOLO26l-sem, YOLO26x-sem
- Оценка глубины: YOLO26n-depth, YOLO26s-depth, YOLO26m-depth, YOLO26l-depth, YOLO26x-depth
- Классификация: YOLO26n-cls, YOLO26s-cls, YOLO26m-cls, YOLO26l-cls, YOLO26x-cls
- Оценка позы: YOLO26n-pose, YOLO26s-pose, YOLO26m-pose, YOLO26l-pose, YOLO26x-pose
- Обнаружение объектов с ориентированными рамками (OBB): YOLO26n-obb, YOLO26s-obb, YOLO26m-obb, YOLO26l-obb, YOLO26x-obb
Эти модели различаются размером и сложностью, обеспечивая разные компромиссы между скоростью и точностью. Изучи полный список предварительно обученных моделей, чтобы выбрать подходящую для своего проекта.
Чтобы выполнить инференс с обученной моделью:
from ultralytics import YOLO # Загрузить модель model = YOLO("path/to/your/model.pt") # Выполнить инференс results = model("path/to/image.jpg") # Обработать результаты for r in results: print(r.boxes) # вывести предсказания bbox print(r.masks) # вывести предсказания масок print(r.probs) # вывести вероятности классовДополнительные параметры инференса, включая пакетную обработку и инференс видео, смотри в подробном руководстве по предсказаниям.
Да. Модели Ultralytics можно развёртывать на различных платформах:
- Периферийные устройства: оптимизируй инференс на таких устройствах, как NVIDIA Jetson или Raspberry Pi, используя TensorRT, ONNX или OpenVINO.
- Мобильные устройства: развёртывай модели на устройствах Android или iOS, преобразовав их в LiteRT или CoreML.
- Облако: используй такие фреймворки, как TensorFlow Serving или TorchServe, для масштабируемого развертывания в облаке.
- Web: реализуй инференс в браузере с помощью ONNX Runtime Web.
Ultralytics предоставляет функции экспорта для преобразования моделей в различные форматы и их развертывания. Изучи широкий выбор вариантов развертывания, чтобы найти лучшее решение для своего сценария использования.
Основные различия:
- Инференс без NMS в сквозном режиме: YOLO26 поддерживает инференс без NMS с помощью
nms=False. В стандартном режиме «один ко многим» используется NMS для повышения точности. - Удаление DFL: в YOLO26 убран модуль Distribution Focal Loss, что упрощает экспорт и улучшает совместимость с периферийными устройствами и устройствами с низким энергопотреблением.
- Оптимизатор MuSGD: гибрид SGD и Muon (вдохновлённый моделью Kimi K2 от Moonshot AI), обеспечивающий более стабильное обучение и быструю сходимость.
- Производительность CPU: YOLO26n выполняет инференс ONNX на CPU до 43% быстрее, чем YOLO11n (Intel Xeon CPU @ 2.00 GHz), поэтому хорошо подходит для устройств без GPU.
- Оптимизация под конкретные задачи: улучшенная сегментация с семантической функцией потерь и прототипами нескольких масштабов, оценка остаточного логарифмического правдоподобия (RLE) для более точной оценки позы и улучшенное декодирование OBB с функцией потерь по углу.
- Задачи: обе модели поддерживают обнаружение объектов и сегментацию экземпляров, а YOLO26 также поддерживает семантическую сегментацию для плотного попиксельного предсказания и оценку глубины по одному изображению для определения глубины каждого пикселя. Обе модели также поддерживают классификацию, оценку позы и обнаружение объектов с ориентированными рамками (OBB) в рамках единой системы.
Подробное сравнение возможностей и метрик производительности смотри на странице документации YOLO26.
- Инференс без NMS в сквозном режиме: YOLO26 поддерживает инференс без NMS с помощью
Вклад в Ultralytics — отличный способ улучшить проект и развить свои навыки. Вот как ты можешь присоединиться:
- Создай форк репозитория Ultralytics на GitHub.
- Создай новую ветку для своей функции или исправления ошибки.
- Внеси изменения и убедись, что все тесты проходят.
- Отправь pull request с понятным описанием изменений.
- Участвуй в проверке кода.
Ты также можешь сообщать об ошибках, предлагать функции или улучшать документацию. Подробные рекомендации и лучшие практики смотри в руководстве для участников.
Ultralytics YOLO предлагает широкий набор функций для решения сложных задач компьютерного зрения:
- Обнаружение в реальном времени: эффективно обнаруживай и классифицируй объекты в режиме реального времени.
- Поддержка множества задач: выполняй обнаружение объектов, сегментацию экземпляров, семантическую сегментацию, оценку глубины по монокулярному изображению, классификацию, оценку позы и обнаружение объектов с заданной ориентацией (OBB) в рамках единой среды.
- Предобученные модели: используй различные предобученные модели, которые обеспечивают баланс между скоростью и точностью для разных сценариев использования.
- Обучение на пользовательских данных: легко дообучай модели на собственных наборах данных с помощью гибкого конвейера обучения.
- Широкий выбор вариантов развертывания: экспортируй модели в различные форматы, например TensorRT, ONNX и CoreML, для развертывания на разных платформах.
- Подробная документация: используй исчерпывающую документацию и поддержку сообщества в рабочих процессах компьютерного зрения.
Повысить производительность модели YOLO можно с помощью нескольких методов:
- Настройка гиперпараметров: экспериментируй с разными гиперпараметрами, следуя руководству по настройке гиперпараметров, чтобы оптимизировать производительность модели.
- Аугментация данных: используй такие методы, как отражение, масштабирование, поворот и изменение цвета, чтобы расширить обучающий набор данных и улучшить способность модели к обобщению.
- Трансферное обучение: возьми предобученные модели и дообучи их на своём наборе данных, следуя руководству по обучению.
- Экспорт в эффективные форматы: преобразуй модель в оптимизированный формат, например TensorRT или ONNX, чтобы ускорить инференс, следуя руководству по экспорту.
- Бенчмаркинг: используй режим бенчмаркинга, чтобы систематически измерять и повышать скорость и точность инференса.
Ultralytics предлагает множество материалов, которые помогут тебе начать работу с нашими инструментами:
- Официальная документация: подробные руководства, справочники API и рекомендации.
- Репозиторий GitHub: исходный код, примеры скриптов и вклад сообщества.
- Блог Ultralytics: подробные статьи, примеры применения и технические материалы.
- Академия Ultralytics: бесплатные курсы по основам компьютерного зрения, обучению первой модели YOLO и запуску YOLO в production.
- Форумы сообщества: общайся с другими пользователями, задавай вопросы и делись опытом.
- Канал YouTube: видеоуроки, демонстрации и вебинары на различные темы Ultralytics.
В этих ресурсах ты найдёшь примеры кода, реальные сценарии использования и пошаговые руководства по различным задачам с моделями Ultralytics.
Если тебе нужна дополнительная помощь, обратись к документации Ultralytics или свяжись с сообществом через GitHub Issues или официальный форум обсуждений.
Комментарии154
Задай вопрос, поделись результатами или помоги кому-нибудь.
oicoyc
Hello, I am really confused and unable to find a solution. I trained YOLOv8n on a dataset with 4000 images for 200 epochs, but during training, the mAP@50 never exceeded 0.4. However, when I use val.py or train.py to test the best.pt file again, the mAP@50 significantly increases to 0.7. Even if I retrain YOLOv8n, I can only get a poor result of 0.4, but this weight file consistently gives a result above 0.7 during testing. What could be the reason for this?
1
Glenn JocherUltralytics@oicoyc it seems like there might be a discrepancy between training and validation settings. Ensure that the dataset and parameters used during validation match those in training. For further insights, you can explore the FAQ section at Ultralytics Documentation.
oicoyc
翻译如下:
However, this
best.ptconsistently shows an mAP@50 above 0.6 on the same dataset, whether usingtrain.pyorval.py. But other weights or retraining the model that generated this weight file never achieve the same result, only reaching 0.4. Have you ever encountered this situation before?
Glenn JocherUltralytics@oicoyc it sounds like there might be a difference in the evaluation settings or data splits between training and validation. Ensure consistency in dataset and parameters. For more insights, check the Ultralytics FAQ.
arifan-instrumentasi-UB
Hello, I am working with custom train yolo v8 model in Colab. I am using image as a source. How can I write a text on result image? I want to write the summary of prediction on the top of result image. Please help.
1
Glenn JocherUltralyticsHello! 😊
To write a summary of your predictions on the top of your result image in Colab using a custom-trained YOLOv8 model, you can leverage the OpenCV library. Here's a quick example on how you can do that:
import cv2 # Assuming 'results' is your YOLOv8 model inference output # Load your image image = cv2.imread('path_to_your_image/image.jpg') # Define the text you want to add summary_text = "Your summary text here" # Set the position, font, scale, color, etc. position = (50, 50) # Adjust based on your requirement font = cv2.FONT_HERSHEY_SIMPLEX font_scale = 1 color = (255, 0, 0) # Blue color in BGR thickness = 2 # Add the text to your image cv2.putText(image, summary_text, position, font, font_scale, color, thickness) # Save or display the result cv2.imwrite('path_to_save_image/summary_result.jpg', image) # or use cv2.imshow('Result', image) to display in Colab (might require additional setup for Colab)Make sure to adjust the path to your image, the
summary_textcontent, and formatting options likeposition,font,fontScale,color, andthicknessaccording to your preferences.Hope this helps! If you have any more questions, feel free to ask. Happy coding! 🚀
arifan-instrumentasi-UB
Hi, thanks for your help. But I have another question.
the image variable in this line have file path. cv2.putText(image, summary_text, position, font, font_scale, color, thickness)
how to call inference result to the image variable without file path (direct to inference result variable without saving the inference result before) ?
thanks again, arifan
Glenn JocherUltralytics(изменено)Hi Arifan,
Glad to help! 😊 To use the result of an inference directly without saving and reloading from a file path in OpenCV, you'll need to work directly with the image array returned by your YOLOv8 inference. After running an inference with your YOLO model, it typically returns an image tensor or array which you can convert to a format suitable for OpenCV operations. Here's a quick example:
from ultralytics import YOLO # Assuming your model is loaded to 'model' and your image to infer is 'your_image' model = YOLO('your_model.pt') results = model('path/to/your_image.jpg') # Perform inference # Get the annotated image as a NumPy array (BGR) for OpenCV inference_img = results[0].plot() # Now you can use cv2.putText directly on the 'inference_img' cv2.putText(inference_img, summary_text, position, font, font_scale, color, thickness) # Show or Save 'inference_img' as needed cv2.imshow('Inference Result with Text', inference_img) cv2.waitKey(0) cv2.destroyAllWindows()In this example,
results[0].plot()returns the annotated image array of the first (or only) image predicted by the model, which you can then manipulate using OpenCV functions likecv2.putTextdirectly without needing to save and reload the image from a path.Hope this clarifies things for you! Let me know if you have any more questions.
arifan-instrumentasi-UB
Hi, so helpful for me. thank you.
now, iam trying the same work using video file as an input. can i using the same code?
Glenn JocherUltralytics(изменено)Hi there! 👋 Glad to hear the previous advice was helpful for you.
For processing a video file, the approach will be slightly different from handling a single image since you'll be working with a stream of frames rather than a static picture. You'll want to loop over each frame in the video, apply the detection, and then optionally write the text on each frame before displaying or saving it.
Here's a simplified snippet to get you started:
import cv2 from ultralytics import YOLO # Load your custom-trained model model = YOLO('path/to/your_model.pt') # Initialize video capture from a file cap = cv2.VideoCapture('path/to/your_video.mp4') while cap.isOpened(): ret, frame = cap.read() if not ret: break # Run model inference on the current frame results = model(frame) frame = results[0].plot() # draw the detections on the frame # [Optional] Customize this part to add your summary text to each frame cv2.putText(frame, 'Your summary text here', (50, 50), cv2.FONT_HERSHEY_SIMPLEX, 1, (255, 0, 0), 2) # Display the frame cv2.imshow('Frame', frame) if cv2.waitKey(1) & 0xFF == ord('q'): # Press 'q' to quit break cap.release() cv2.destroyAllWindows()Make sure to adjust the paths, model, and summary text as needed. This code assumes you're working within an environment that supports OpenCV displays (like Jupyter or running locally).
For real-time performance or handling larger videos, consider optimizations 🚀 such as reducing
imgszfor faster processing or using a more powerful GPU.arifan-instrumentasi-UB
so we only need to put text on frame from cap.read() and no need to put on inference result?
Glenn JocherUltralyticsHi there! 😊
Yes, you're exactly right! For adding text to your video frames, you'll directly work with the frame obtained from
cap.read()rather than the inference result. Here's how you can do it:# Example code snippet import cv2 cap = cv2.VideoCapture('path/to/your_video.mp4') while True: ret, frame = cap.read() if not ret: break # Place your text on the frame here cv2.putText(frame, "Your Text Here", (10,30), cv2.FONT_HERSHEY_SIMPLEX, 1, (255,255,255), 2) # Show the frame cv2.imshow('Frame', frame) if cv2.waitKey(1) & 0xFF == ord('q'): break cap.release() cv2.destroyAllWindows()This approach lets you dynamically display information directly on the video stream. 📹 If you have more questions or need further assistance, feel free to ask. Happy coding!
oukkahe
Hi Paula!
I have not reported anything for months now.
I do not understand what this is about.
BR,
Heikki
From: Paula Derrenger @.> Sent: Monday, 24 August 2026 13.36 To: ultralytics/ultralytics @.> Cc: oukkahe @.>; Comment @.> Subject: Re: [ultralytics/ultralytics] help/FAQ/ (Discussion #7928)
Please share the exact upload/training error and your dataset structure. Segmentation labels must follow the Ultralytics segmentation dataset format https://docs.ultralytics.com/datasets/segment , with one matching .txt file per image containing normalized polygon coordinates and at least three points per object; please continue posting details here so the Ultralytics team can investigate.
— Reply to this email directly, view it on GitHub https://github.com/orgs/ultralytics/discussions/7928?email_source=notifications&email_token=AFVEEPWRWQTVMISQRP7QBFT5LQLBFA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBRGMZTQMBZUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#discussioncomment-18133809 , or unsubscribe https://github.com/notifications/unsubscribe-auth/AFVEEPWBYBSTVGYGSCVFGRL5LQLBFAVCNFSNUABHKJSXA33TNF2G64TZHM2TGNJTGYYDINBVHNCGS43DOVZXG2LPNY5TMMJWGEYTKONBOYBA . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS https://github.com/notifications/mobile/ios/AFVEEPSGHO5VYLT4OEILRNL5LQLBFA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBRGMZTQMBZUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSVGM33PORSXEX3JN5ZQ and Android https://github.com/notifications/mobile/android/AFVEEPQNNBDUPPWWHNQECST5LQLBFA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBRGMZTQMBZUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ . Download it today! You are receiving this because you commented. https://github.com/notifications/beacon/AFVEEPVFS7CXU7IMCBMQ3ZD5LQLBFBFCNFSM6AAAAAC6DDWSKOWGG33NNVSW45C7OR4XAZNRIRUXGY3VONZWS33OINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQBCSZTDJTSMVQXG33OU5RW63LNMVXHI.gif Message ID: @.*** @.***> >
UserWhy can't my segmentation be uploaded in the model? It's impossible to conduct training.
Paula DerrengerUltralyticsPlease share the exact upload/training error and your dataset structure. Segmentation labels must follow the Ultralytics segmentation dataset format, with one matching
.txtfile per image containing normalized polygon coordinates and at least three points per object; please continue posting details here so the Ultralytics team can investigate.
User为什么我的分割在模型里面上传不了,没办法训练
oukkahe
Hello Ultralytics! Keep up the good work. I am wondering if there is any support or sample code for using Yolo11 with openVino in c++? I am aware of Python openVino support. Something like that for c++ would be great.
Glenn JocherUltralyticsWe don’t currently maintain an official Ultralytics C++ OpenVINO inference sample in this repo; the recommended workflow is to export your YOLO11 model to OpenVINO IR using our OpenVINO integration docs and then run it with the native OpenVINO C++ runtime (you’ll need to implement YOLO11 pre/post-processing in C++, including NMS—if you want a simpler end-to-end export path, consider Ultralytics YOLO26).
yolo export model=yolo11n.pt format=openvino
Narayanan-nans
Hi Team, Thanks for doing great works in the computer vision field. I want to know whether do you have any idea to integrate cupy with ultralytics packages in place of numpy & scipy, If you do have when can we expect the same to be integrated? Thanks in advance
ralekz
Hi! Your neural network claims that your Yolo11 models come with feature map stride parameters of 32, 16, and 8. How can I also get your detection models with feature map stride = 4? Can I download the entire line of detection models with this parameter? Can I change this parameter myself? I need to predict small details with greater accuracy...
Glenn JocherUltralytics@ralekz you’re right that the standard YOLO11 detection models use 8/16/32 strides, and we don’t currently publish a variant with a stride‑4 detection head, so there’s nothing to “just download” for that. To get stride 4 you’d need to modify the model YAML (add an extra low‑stride feature map / detection head) and then train or fine‑tune that custom architecture; simply changing a stride value on an existing
.ptwithout retraining is not supported and will generally degrade performance. For an overview of how the YOLO11 backbone and head are defined so you can experiment safely, see the YOLO11 model page and its links to configuration details.1
ralekz
Hi, thank you for your support! I can't figure out how to further train my YOLO 11 model. For example, I have a dataset of 150,000 labeled images of Toyota cars, and it works perfectly. But in the new year, a new model is released, and the old ones have been restyled. How can I add predictive capabilities to my model for these new and updated models without losing the previous training skills? Is it really only possible to use a combined dataset?
ralekz
That moment when I sewed my own severed arms back on with my own feet... Give me back my thanks.
Glenn JocherUltralytics(изменено)@alexs-rufer the
self.hyp.boxerror means the internal detection model hasn’t had its training hyperparameters (hyp) initialized into the object the loss expects; that setup is normally done only when you go through the built‑inmodel.train(...)/ Trainer pipeline, which then callsself.model(batch)for you. Directly callingmodel.model(batch)is therefore using internal APIs that assume the Trainer has already populatedself.hypand the loss object, so things break when you bypass it. For a stable solution, I’d recommend basing your Active Teacher loop on the existing detection trainer (copying or subclassing it and overriding the training step) rather than callingmodel.model(batch)in isolation; the reference implementation inultralytics/models/yolo/detect/train.pyshows exactly how the batch dict and loss forward are wired together.@barath38 to get very accurate box/segment predictions for your 3D coordinate use case, focus first on having perfectly drawn masks/boxes and training data that really matches your deployment setup (same camera height, distance, row/column layout, and lighting), rather than just collecting thousands of random box images. A few hundred well‑annotated examples per box type and viewpoint, combined with strong augmentation (rotations, perspective changes, zoom, brightness/contrast) usually gives better results than many near‑duplicate images; you can also crop around the grid so each box is larger in the frame, which helps both segmentation quality and depth stability. For concrete guidance on how much data and what variety to target, see the Data Collection and Annotation guide together with the Preprocessing annotated data guide.
@sarath-knackforge there’s no supported way to “merge” two YOLOv8 checkpoints into a single model in a clean, automatic way; in practice you either retrain one model on a combined dataset (license-plate data plus your custom data, with a unified label set) or you keep two separate models and run them sequentially in your pipeline. If you go with the single-model approach, just merge the datasets and train one YOLO model as usual; the object-detection docs at the YOLO detection task page show how to structure multi-class datasets for this.
@ralekz no worries on the earlier comment—on the technical side, if you want your YOLO11 model to keep performing well on the existing Toyota models while learning the new and restyled ones, you do need to keep training on some mix of old and new data; training only on the new models will typically cause forgetting of the older variants. You don’t have to keep all 150k old images in the loop, but sampling a representative subset and mixing them with the new-model images, then fine‑tuning from your current
best.pt, is the standard way to extend the model without losing past knowledge. Longer term, treating this as a recurring maintenance process—periodically adding new data, rebalancing the mix, and re‑validating—is best practice; the guide on maintaining your computer vision models after deployment walks through that workflow in more detail.1ralekz
Thanks for the answer, it turns out there is no shortcut.
sarath-knackforge
Hi team, i have one doubt , i already done research in online but i didn't get proper finalized answer. i want to merge two separate model into single model , i want to merge yolo8 licence plate detection model with my custome fine tune model ( used yolo8s.pt pretrained model to train), so can i able to merge both modle into single mode ?
Thank you.