PP-YOLOE

PP-YOLOE is an anchor-free object detector with detection training and class-head resizing.

Tasks
detection
Sizes
s, m, l, x at 640 px
Install
pip install libreyolo
Support tier
Supported, since v1.6.0. Supporting trainables: kept green in CI, features land opportunistically.
Licenses
Code MIT, weights No separate artifact grant recorded. Commercial use

Install

bash
pip install "libreyolo"

Predict

Python
from libreyolo import LibreYOLO, SAMPLE_IMAGE model = LibreYOLO("LibrePPYOLOEs.pt", device="cpu")result = model(SAMPLE_IMAGE)print(result.boxes)

Released weights download from the source CDN with a pinned SHA-256 check. The constructor also accepts a local upstream checkpoint. The four sizes are s, m, l and x.

Train

Training uses ATSS assignment before switching to task-aligned assignment. static_assigner_epochs defaults to 30% of the requested epochs. A new class count rebuilds the class-prediction layers. AMP defaults to False.

Dataset setup describes the required training data.

Python
from libreyolo import LibreYOLO model = LibreYOLO("LibrePPYOLOEs.pt", device="cpu")# coco8 is a small YOLO-format detection dataset that downloads automatically.model.train(data="coco8.yaml", epochs=1, device="cpu", workers=0)

Validate

Python
from libreyolo import LibreYOLO model = LibreYOLO("LibrePPYOLOEs.pt", device="cpu")metrics = model.val(data="coco8.yaml", workers=0)print(metrics)

Use the dataset format for this task. Validation explains the dataset requirements and returned metrics.

Export

TaskONNXTorchScriptExecuTorchTensorRTOpenVINOPaddleMNNRKNNncnnTFLiteCoreMLCore AI
DetectionDetection to ONNX: supportedDetection to TorchScript: supportedDetection to ExecuTorch: supportedDetection to TensorRT: supportedDetection to OpenVINO: supportedDetection to Paddle: not supportedDetection to MNN: not supportedDetection to RKNN: not supportedDetection to ncnn: supportedDetection to TFLite: not supportedDetection to CoreML: not supportedDetection to Core AI: not supported
Python
from libreyolo import LibreYOLO model = LibreYOLO("LibrePPYOLOEs.pt", device="cpu")model.export(format="onnx")

Export setup lists format dependencies and loading exported artifacts.

Licensing

Check the license on the Hugging Face repository of the specific weights you download. Every checkpoint in the LibreYOLO org carries one, and they are not always the same across a family. That repository is the authoritative source; the summary below describes what applied when this page was last verified.

This is a description of the licenses involved, not legal advice. If the answer matters commercially, read the licenses yourself and take your own counsel.

Original work
PP-YOLOE, PaddlePaddle
Upstream license
Apache-2.0
LibreYOLO code
MIT
Weights
No separate artifact grant recorded, distributed by their authors. LibreYOLO does not host or mirror them.
Interpretation
The upstream source is Apache-2.0. Pretrained artifacts download from the source CDN; a separate checkpoint license grant has not been recorded.

Verified against LibreYOLO v1.6.0. Support tables, checkpoints and benchmark numbers on this page are generated from the released library and the published weights, not written by hand.

PP-YOLOE architecture

Select a variant or family overview, then select a block for details. Open the full diagram to zoom or download SVG and PNG.