中文 · 한국어 · 日本語 · Русский · Deutsch · Français · Español · Português · Türkçe · Tiếng Việt · العربية
Ultralytics YOLO 文档#
Ultralytics YOLO 是一个实时计算机视觉模型系列,可用于目标检测、实例分割、语义分割、深度估计、分类、姿态估计、有向边界框和跟踪,并可通过一个 Python 软件包和 CLI 使用。YOLO26 基于近期深度学习研究成果,支持可选的无需NMS的端到端推理,并针对边缘部署进行了优化。其精简设计可适配各种应用场景和硬件,从边缘设备到云端 API。对于稳定的生产工作负载,推荐使用YOLO26和YOLO11。
浏览 Ultralytics 文档,全面了解 YOLO 软件包和 CLI,以及Ultralytics Platform;后者基于相同模型提供数据标注、云端训练和部署功能。无论你是经验丰富的机器学习从业者,还是刚接触这一领域,这些资源都能帮助你在项目中充分发挥 YOLO 的作用。
如需商业用途,请通过 Ultralytics Licensing 申请企业许可证。
探索 YOLO27 预览版,了解架构详情、初步基准测试结果,以及发布后可供参考的示例。模型正在进行最后阶段的研发,预计将于今年晚些时候推出;目前尚未开放使用,也未确定发布日期。
将单张照片转换为深度图,为每个像素提供以米为单位的距离。
两条命令即可开始#
# Install the ultralytics package from PyPI
pip install ultralytics
# Detect objects in an image with a pretrained YOLO26 model
yolo predict model=yolo26n.pt source='https://github.com/ultralytics/assets/releases/download/v0.0.0/bus.jpg'模型权重和示例图像会自动下载,带标注的结果将保存在命令输出的目录中;首次运行时,该目录为 runs/detect/predict。
查看 快速入门 指南,了解所有安装方式以及如何运行你的首次预测。
你想做什么?#
本文档的组织方式#
大多数模型工作流 yolo 命令都遵循同一种语法 yolo [TASK] MODE ARGS,其中 Task 为可选项;本文档也围绕相同的三个部分组织,并额外提供一个快捷入口:
- 任务回答了你想从图像中获取什么:检测、实例分割、语义分割、深度估计、分类、姿态估计或有向框。
- 模式回答了你如何使用模型:训练、验证、预测、导出、跟踪或基准测试。
- 参数用于配置命令,包括选择要运行的模型(使用
model=),以及设置epochs和imgsz等超参数。 - 解决方案是快捷入口:它提供现成的应用,例如目标计数或安全警报,无需经过 Task 和 Mode。
其他所有内容都围绕这一语法展开:模型列出所有可传递给 model= 的架构——YOLO26、YOLO11、SAM 3、RT-DETR 等;数据集介绍每个 Task 使用的训练数据;指南汇集了丰富的深度教程,涵盖硬件部署、超参数调优、数据集转换和完整项目实践;集成将工作流连接到你已在使用的训练和部署工具;参考部分则记录了 Python API 中的所有类和函数。
除了 Python 包之外,还有两个基于相同模型运行的入口:Ultralytics Platform用于云端标注、训练和部署;Ultralytics Inference则是一个独立的 Rust 库和 CLI,可在不运行 Python 环境的情况下运行导出的模型。
YOLO 许可:Ultralytics YOLO 如何授权?#
Ultralytics 提供两种许可选项,以满足不同的使用场景:
- AGPL-3.0 许可证:这项经 OSI 批准的开源许可证非常适合学生和爱好者,有助于推动开放协作和知识共享。更多详情请参阅 LICENSE 文件。
- 企业许可证:此许可证适用于开发和生产用途,允许将 Ultralytics 软件和 AI 模型集成到商业产品和服务中,包括内部工具、自动化工作流和生产部署,同时免除 AGPL-3.0 的开源要求。要开始使用,请通过 Ultralytics Licensing 联系我们。
我们的许可策略旨在确保对开源项目所做的任何改进都能回馈社区。我们相信开源;我们的使命是确保每个人都能以有益于所有人的方式使用和拓展我们的贡献。
常见问题#
在你的数据集上训练自定义 YOLO 模型分为三个步骤:
- 准备好已标注的数据集,并在数据集 YAML 文件中描述该数据集。
- 加载一个预训练模型,例如在 Python 中使用
YOLO("yolo26n.pt")。 - 使用
model.train(data="path/to/dataset.yaml", epochs=100, imgsz=640)启动训练,或在命令行中运行yolo detect train data=path/to/dataset.yaml epochs=100 imgsz=640。
如需详细操作说明,请参阅我们的训练模型指南,其中包含示例以及优化训练流程的技巧。
Ultralytics 为 YOLO 提供两种许可选项:
- AGPL-3.0 许可证:这项开源许可证非常适合教育和非商业用途,并鼓励开放协作。
- 企业许可证:适用于开发和生产用途,包括内部工具、自动化工作流和生产部署,同时免除 AGPL-3.0 的开源要求。
如需了解详情,请访问我们的许可页面。
Ultralytics YOLO 支持高效且可自定义的多目标跟踪。在 Python 中调用
YOLO("yolo26n.pt").track(source="path/to/video.mp4"),或在命令行中运行yolo track source=path/to/video.mp4——两者都支持视频文件、实时流和网络摄像头输入。如需了解如何设置和运行目标跟踪,请参阅我们的跟踪模式文档,其中介绍了实时场景中的配置和实际应用。
评论689
提出问题、分享结果,或帮助其他人。
Glenn JocherUltralyticsHi everyone 👋! I created this new comments section in our Docs 📚 so you can provide feedback! Tell us what you like and what you don't like, and we'll do our best to improve the Docs to be more informative and helpful for everyone. Thank you 🙏
11torkiasalem
which activation function do we use in the output layer of yolov8 ?
saydek217
I think it is a SiLU activation function based on the "modules.py" file in the source code. waiting for confirmation ofc, meanwhile you can take a look on the superb work of RangeKing here: https://github.com/ultralytics/ultralytics/issues/189
1torkiasalem
I think In YOLOv8, the default activation function used is the LeakyReLU function. Check this tutorial Understanding Hyper-parameter-tuning of YOLO’s
Glenn JocherUltralyticsnn.SiLU() is the default YOLOv8 activation, but it is not used in output layers, only internally after convolution + BN layers. Externally outputs are either in logits or pass through Sigmoid() activations.
AmeerAlahmadi
can you please explain how to convert yolov8 to edgetpu to be used with coral usb accelerator and raspberry pi 4?
Glenn JocherUltralytics@AmmerAlahmadi sure! You can start with just
yolo export model=yolov8n.pt format=edgetpu. See https://docs.ultralytics.com/modes/export/ for details. Once export is complete you'll see usage examples for running prediction with your export Edge TPU model.AmeerAlahmadi
Great! Thanks a lot for your kind reply, I really appreciate it.
ndnesh
Has anyone tested the Nvidia A16 against MultiGPU training? I have 1 Nvidia A16 (note that it's a GPU which has 4x A2 cores on each Physical board). And when trying with Multi-GPU training, even with the default models/ code given above, it fails and crashes my server.
Paula DerrengerUltralytics@ndnesh i'm sorry to hear you're experiencing issues with Multi-GPU training on the Nvidia A16. We haven't received similar reports yet. Could you please open a new issue on the Ultralytics YOLOv8 GitHub repo with the error logs and details about your setup? This will help us diagnose the problem and provide a solution. Make sure to include information such as the command you're running, the output leading up to the crash, and any modifications you've made to the code or environment. 🛠️
zoegrace23
Really appreciate the effort on this! The yolov8 documentation has come a long way—it's clear and beginner-friendly, which makes experimenting with new features much easier.
1
Glenn JocherUltralyticsThank you for the kind words about the documentation! However, I'd like to point you to our official documentation at docs.ultralytics.com which is the most up-to-date and comprehensive resource for YOLOv8. We're constantly working to improve it and make it more accessible for users at all levels. Your feedback helps us continue to enhance the experience!
panjonsen
我需要c#调用的话需要如何去做
1
Paula DerrengerUltralytics您好!😊 如果您想在C#环境中调用YOLOv8模型,建议导出模型到ONNX格式,然后使用比如Microsoft.ML.OnnxRuntime库来加载和使用ONNX模型。
这里有一个基本步骤示例:
-
导出模型到ONNX格式: 使用CLI命令:
yolo export model=yolov8n.pt format=onnx -
在C#中使用ONNX Runtime加载和使用模型:
using Microsoft.ML.OnnxRuntime; using Microsoft.ML.OnnxRuntime.Tensors; // 加载模型 var session = new InferenceSession("path_to_your_model.onnx"); // 创建一个输入张量 var inputMeta = session.InputMetadata; var inputTensor = new DenseTensor<float>(new[] {1, 3, 640, 640}); // 假设输入是1x3x640x640 // 创建一个名字到张量的映射,并进行预测 var inputs = new List<NamedOnnxValue> { NamedOnnxValue.CreateFromTensor("input_name", inputTensor) }; // 运行模型 using (var results = session.Run(inputs)) { // 从results中获取您的输出 }
请确保将
"path_to_your_model.onnx"替换为您的ONNX模型的实际路径,同时根据您的模型输入适当调整输入张量的形状。希望这有助于您开始!如果有任何其他问题或需要进一步的帮助,欢迎随时提问。
-1-
deepaks11
Can I train the face emotion dataset in yolov8
1RizwanMunawar
@deepaks11! What I understood from your question is that you want to train ultralytics YOLOv8 for face emotion detection. If this is the case, then yes you can use the YOLOv8 for face emotions detection.
For more details, you can take a look at ultralytics documentation!
noocap
import cv2 as cv import numpy as np from PIL import ImageGrab from ultralytics import YOLO
modelo = YOLO('last.pt') def janela(): while (True):
screen = np.array(ImageGrab.grab()) screen = cv.cvtColor(src=screen, code=cv.COLOR_BGR2RGB)
modelo.predict(screen, show=True)janela()
Could someone help me in a way to get the wy position of the center of the box?
I've tried a lot of things but I still haven't been successful.
1
Glenn JocherUltralytics(已编辑)@noocap certainly! To obtain the y-coordinate of the center of the bounding box, you can use the
resultsobject returned by thepredict()method. Theresultsobject contains aBoxesattribute, which holds the bounding box coordinates in various formats, includingxyxy(xmin, ymin, xmax, ymax) andxywh(x-center, y-center, width, height).Here's how you can modify your
janela()function to get the y-coordinate of the center of each detected box:import cv2 as cv import numpy as np from PIL import ImageGrab from ultralytics import YOLO # Load the model model = YOLO('last.pt') def janela(): while True: # Capture the screen screen = np.array(ImageGrab.grab()) # Convert the screen capture to the correct color format screen = cv.cvtColor(screen, cv.COLOR_BGR2RGB) # Run prediction results = model.predict(screen) # Iterate over the detected boxes for box in results[0].boxes: # Get the y-coordinate of the center of the box xc, yc, w, h = box.xywh[0] print(f'Center Y-coordinate: {yc}') # If you want to visualize the results annotated_frame = results[0].plot() cv.imshow('YOLOv8 Prediction', annotated_frame) if cv.waitKey(1) == ord('q'): # Press 'q' to quit break janela()In this code snippet,
box.xywh[0]retrieves the bounding box inxywhformat for each detection, andycrepresents the y-coordinate of the center of the box. Theprintstatement outputs the y-coordinate to the console.Remember to handle the window display and breaking out of the loop appropriately if you're showing the predictions with
cv.imshow(). Thecv.waitKey(1)function is used to capture keyboard input, allowing you to exit the loop by pressing 'q'.
agungmrf
hello, here I am doing research using Yolov8 to detect the sign language alphabet. but to display output in the form of sound or text to speech it still doesn't work, can anyone help?
the following is the code
import torch import cv2 from numpy import ndarray as nd from ultralytics import YOLO
model = YOLO('models/best.pt')
Set the camera capture properties
cap = cv2.VideoCapture(0) cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640) cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480)
Set the desired frame rate
frame_rate = 30 delay = int(1000 / frame_rate)
while cap.isOpened(): ret, frame = cap.read()
results = model(frame) cv2.imshow('Detection-Bisindo', nd.squeeze(results[0].plot())) if cv2.waitKey(delay) & 0xFF == ord('q'): breakcap.release() cv2.destroyAllWindows()
1
Glenn JocherUltralytics@agungmrf hello! It's great to hear that you're using YOLOv8 for sign language detection. To add text-to-speech functionality to your code, you can use Python's
gttslibrary (Google Text-to-Speech) orpyttsx3for offline text-to-speech conversion. Below is an example of how you can integrategttsinto your existing code:First, install the
gttslibrary if you haven't already:pip install gttsThen, modify your code to include text-to-speech functionality:
import torch import cv2 from numpy import ndarray as nd from ultralytics import YOLO from gtts import gTTS import os model = YOLO('models/best.pt') # Set the camera capture properties cap = cv2.VideoCapture(0) cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640) cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480) # Set the desired frame rate frame_rate = 30 delay = int(1000 / frame_rate) def speak(text): tts = gTTS(text=text, lang='en') tts.save('output.mp3') os.system('start output.mp3') while cap.isOpened(): ret, frame = cap.read() results = model(frame) # Assuming your model's results contain the class names of detected signs for result in results: if result.boxes: labels = result.boxes.cls # Get the class names using the labels class_names = [model.names[i] for i in labels] # Speak out the first detected class name for simplicity if class_names: speak(class_names[0]) break # Only speak the first detected sign per frame cv2.imshow('Detection-Bisindo', nd.squeeze(results[0].plot())) if cv2.waitKey(delay) & 0xFF == ord('q'): break cap.release() cv2.destroyAllWindows()This code snippet uses
gttsto convert the detected class name into speech. It saves the speech as an MP3 file and then plays it using the default media player. Note that this is a simple implementation and will speak out the name of the first detected class in each frame. You might want to add additional logic to handle multiple detections or to prevent the same sign from being spoken repeatedly.If you prefer an offline solution, you can use
pyttsx3instead, which doesn't require an internet connection. Install it using:pip install pyttsx3And use the
speakfunction like this:import pyttsx3 engine = pyttsx3.init() def speak(text): engine.say(text) engine.runAndWait()Replace the
speakfunction in the previous code with this one, and you'll have offline text-to-speech functionality.I hope this helps! If you have any further questions or need assistance with your project, feel free to ask.
H-Tudor
I have trained a yolov8n model (on 3 classes) and need to run it in the most efficient way. After researching TVM's compilation I was stuck with a numpy array of 1x7x8400. My question is how to interpret this array as to get the bounding boxes/ classes and confidence. Thanks in advance.
PS: I could use more documentation on the inference process (besides the "Predict" page) and its output, where could i find it?
1H-Tudor(已编辑)
For anyone with the same issue as i had, I found the answer 6 Months later buried in the examples
Theory:
- yolov5 has an output of shape (batchSize, 25200, 85) (Num classes + box[x,y,w,h] + confidence[c])
- yolov8 has an output of shape (batchSize, 84, 8400) (Num classes + box[x,y,w,h])
My yolo model has an output of 1x7x8400:
- 1 = batch size for single image inference
- 7 = 3 classes + 4 params (x, y, w, h)
- 8400 = subdivisions I suppose (must be concatenated using NMS)
C++ decoder can be found at: ultralytics/examples/YOLOv8-CPP-Inference/inference.cpp/Inference::runInference I encourage reading these examples and also some modification of the .cpp and .h is required
Paula DerrengerUltralytics(已编辑)@H-Tudor i'm glad to hear you found the solution to your issue! 🎉 The output shape you've described is indeed the raw predictions from the model, which include the bounding box coordinates and the per-class scores (YOLOv8 has no separate objectness score).
For interpreting the output array, you typically need to apply a post-processing step, such as Non-Maximum Suppression (NMS), to filter out overlapping boxes and select the most probable detections.
Regarding additional documentation on the inference process and its output, the best place to look would be the Ultralytics YOLOv8 GitHub repository, specifically within the
examplesdirectory, as you've already discovered. The C++ inference example you mentioned is a great resource for understanding how to decode the raw model output.If you have further questions or need more assistance, feel free to open an issue in the GitHub repository, and the community will be happy to help. Keep in mind that the repo is continuously updated, so staying tuned for any new documentation or examples is always a good idea.
Happy coding with YOLOv8! 🚀
1complete-dope
@petergreis Could you please give a detailed output for the 8400 ? like the actual breakdown !!
I have seen it at lot of places and many are confused ... could you please solve that !!
raniasyed
Hi, I am making an object detection system with YOLOv8 with a custom dataset, I have a trained model named best.pt The problem is I need to deploy this model on flask to use the webcam. I am unable to do that with yolov8 as it gives a lot of errors. Please help me with it
1sam-a-d
If you visit model.py in ultralytics, you can see the following line where they defined the resources themselves, the code is
Define the trainable function with allocated resources
trainable_with_resources = tune.with_resources(_tune, {'cpu': 8, 'gpu': gpu_per_trial if gpu_per_trial else 0})
so yo can override the no of cpu in your own going to the main method as this method does not get cpu values as a parameter.
sam-a-d
sorry for my previous reply, I meant to put this somewhere else.
flashzzz
Can you provide more details on the specific errors you're facing?
raniasyed
Hi, the error that I am facing says that: cv2.error: opencv(4.7.0) d:\a\opencv-python\opencv-python\opencv\modules\imgcodecs\src\loadsave.cpp:692: error: (-2:unspecified error) could not find a writer for the specified extension in function 'cv::imwrite_' I have tried updating the opencv version, im using only the jpg format, but i still cant seem to find the error.
flashzzz
can you provide the code snippet
raniasyed
@app.route("/") def index(): return render_template('index.html')
@app.route("/", methods=["GET", "POST"]) def predict_img(): if request.method == "POST": if 'file' in request.files: f = request.files['file'] basepath = os.path.dirname(file) filepath = os.path.join(basepath, 'uploads', f.filename) print("upload folder is ", filepath) f.save(filepath) global imgpath
predict_img.imgpath = f.filename print("printing predict_img :::::: ", predict_img) file_extension = f.filename.rsplit('.', 1)[1].lower() if file_extension == 'jpg': img = cv2.imread(filepath) frame = cv2.imencode('.jpg', cv2.UMat(img))[1].tobytes() print('Hello') image = Image.open(io.BytesIO(frame)) yolo = YOLO('best.pt') detections = yolo.predict(image, save=True) #return display(f.filename) elif file_extension == 'mp4': video_path = filepath cap = cv2.VideoCapture(video_path) frame_width = int(cap.get(cv2.get(cv2.CAP_PROP_FRAME_WIDTH))) frame_height = int(cap.get(cv2.get(cv2.CAP_PROP_FRAME_HEIGHT))) fourcc = cv2.VideoWriter_fourcc(*'mp4v') out = cv2.VideoWriter('output.mp4', fourcc, 30.0, (frame_width, frame_height)) model = YOLO('best.pt') while cap.isOpened(): ret, frame = cap.read() if not ret: break results = model(frame, save=True) print(results) cv2.waitKey(1) res_plotted = results[0].plot() cv2.imshow('results', res_plotted) out.write(res_plotted) if cv2.waitKey(1)==ord('q'): break return video_feed() folder_path = 'runs/detect/train' subfolders = [f for f in os.listdir(folder_path) if os.path.isdir(os.path.join(folder_path, f))] latest_subfolder = max(subfolders, key=lambda x: os.path.getctime(os.path.join(folder_path,x) )) image_path = folder_path + '/' + latest_subfolder + '/' + f.filename return render_template('index.html', image_path = image_path)@app.route('/path:filename') def display(filename): print('Indisplay') folder_path = 'runs/detect/train' subfolders = [f for f in os.listdir(folder_path) if os.path.isdir(os.path.join(folder_path, f))] latest_subfolder = max(subfolders, key=lambda x: os.path.getctime(os.path.join(folder_path, x))) directory = folder_path+'/'+latest_subfolder print('printing directory', directory) files = os.listdir(directory) #print('HI') if files: latest_file = files[0] print(latest_file) else: print('No files found in directory')
filename = predict_img.imgpath print('After Filename') file_extension = filename.rsplit('.', 1)[1].lower() environ = request.environ if file_extension == 'jpg': print('infileext') if os.path.exists(os.path.join(directory, latest_file)): return send_from_directory(directory, latest_file, environ) else: return 'FILE DOES NOT EXIST' else: return 'INVALID FILE FORMAT'@app.route("/webcam_feed") def webcam_feed(): ip_address = "rtsp://admin:admin123@192.168.1.2:554/cam/realmonitor?channel=1&subtype=0&unicast=true&proto=Onvif" cap = cv2.VideoCapture(ip_address) model = YOLO('runs/detect/train/weights/best.pt') fps = int(cap.get(cv2.CAP_PROP_FPS))
fourcc = cv2.VideoWriter_fourcc('m', 'p', '4', 'v') frame_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH)) frame_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT)) show_boxes = False out = cv2.VideoWriter('output.mp4', fourcc, fps, (frame_width, frame_height), True) while (cap.isOpened()): ret, frame = cap.read() if ret == True: person_found = False results = model(frame, imgsz=640, stream=True, verbose=False) for result in results: for box in result.boxes.cpu().numpy(): if show_boxes: r = box.xyxy[0].astype(int) cv2.rectangle(frame, r[:2], r[2:], (255, 255, 255), 2) cls = int(box.cls[0]) if cls == 0: person_found = True return render_template('index.html') @app.route('/video_feed')def video_feed(): print('Function called') return Response(get_frame(), mimetype='multipart/x-mixed-replace; boundary=frame')
if name == 'main': app.run(debug=True) parser = argparse.ArgumentParser(description="Flask app exposing yolov8 models") parser.add_argument("--port", default=5000, type=int, help="port number") args = parser.parse_args()
flashzzz
did you install opencv using conda?
raniasyed
no i didnt
flashzzz
Then I think the issue lies with the writer plugins. I'll let you know if I find something
raniasyed
sure, thank you!
kopyl
What are the errors?
Paula DerrengerUltralytics@kopyl it seems there was a misunderstanding earlier. The error you're encountering is related to OpenCV's
imwritefunction, which is used to save images to disk. The error message indicates that OpenCV cannot find a writer for the specified file extension, which in your case is.jpg.This issue can occur if OpenCV was not installed with the proper image codecs or if there's an issue with the file path or permissions. Here are a few steps you can take to resolve the issue:
-
Check File Path: Ensure that the path where you're trying to save the image exists and that your application has write permissions to that directory.
-
Reinstall OpenCV: Uninstall and reinstall OpenCV with all the necessary codecs. If you're using
pip, you can do this with:pip uninstall opencv-python pip install opencv-python -
Use Absolute Path: When saving the image, use an absolute path to avoid any relative path issues.
-
Check Disk Space: Make sure you have enough disk space on the drive you're writing to.
-
File Extension: Double-check that the file extension is correct and that you're not appending any non-standard characters to it.
-
Update OpenCV: If you're not using the latest version of OpenCV, consider updating it as there might be fixes in the newer versions.
If you continue to face issues, please provide the exact line of code that's causing the error, and I'll be happy to help you further debug the problem.
-
Aminezaghdoudi08
I am writing my thesis on error detection in Alumnium using YOLOv8 and have not found any documentation on the architecture of the algorithm. Can you please give me more details about it and how it works? so I can present it.
Kind regards
1torkiasalem
@Aminezaghdoudi08 Hello! check this
Aminezaghdoudi08
Thank you very much for the answer. Can you please give me more details. Especially about the parameters used.
torkiasalem
@Aminezaghdoudi08 The YOLOv8 architecture consists of two main parts: the backbone and the head. The backbone is a modified version of the CSPDarknet53 architecture. The head consists of multiple convolutional layers followed by a series of fully connected layers, responsible for predicting bounding boxes, objectness scores, and class probabilities for the objects detected in an image . Some other parameters used in YOLOv8 include: Input size: Default input size is 640x640 . Number of layers: Default number of layers is set to 53.
For BBox loss, YOLOv8 employs the CIoU and DFL loss functions, as well as BCE for cls loss. These losses have been proven to increase object identification performance, especially with tiny objects. I hope this explanation helps clarify your questions. Let us know if you have any further questions or concerns!
2
daisheng123
I looked at the parsing function in deepstream-yolo-pose, and it only handles single-class human pose estimation. How should it be parsed for multiple classes?
Glenn JocherUltralyticsUltralytics pose models assume a single keypoint layout (one
kpt_shape/skeleton), so you can only do “multi-class pose” with one DeepStream parser if all classes share the same keypoint definition; in that case, parse keypoints exactly the same way and just use each detection’s predicted class id (cls) to tag/group the instance (see the Ultralytics pose task docs). If your classes need different keypoint counts/semantics, you’ll need separate pose models/engines (or run detection first, then a class-specific pose model), since one output tensor shape can’t represent multiple skeletons cleanly.







