LibreYOLO
⭐ Support LibreYOLO. The best way to help is to star the repo. Feel free to open an issue if you encounter problems or have suggestions, and code contributions are very welcome (see CONTRIBUTING.md).
MIT-licensed computer vision library with inference and training support for a variety of models. It provides a familiar high-level Python and CLI interface and reads common YOLO-format datasets, so existing workflows port over with minimal changes.
Installation & Quick start
pip install libreyolo
from libreyolo import LibreYOLO, SAMPLE_IMAGE
model = LibreYOLO("LibreYOLO9t.pt")
result = model(SAMPLE_IMAGE, save=True)
Optional pip extras
The base install covers YOLOv9 and the other detection models, plus training
and inference. Add an extra in brackets when you need a heavier model family
(for example RF-DETR, which needs transformers) or an export backend.
Comma-separate to combine, e.g. pip install "libreyolo[rfdetr,onnx]":
| Group | Extras |
|---|---|
| Export | onnx, tensorrt, openvino, ncnn, tflite (alias: litert), coreml |
| Models | rfdetr, vlm, sam, openvocab, clip, gaze |
| Training | lora, plots, tensorboard, mlflow, wandb |
| Everything | pip install "libreyolo[all]" |
For the full list of extras and per-backend notes, see the docs.
To install from source (development, or to track unreleased changes):
git clone https://github.com/LibreYOLO/libreyolo.git
cd libreyolo
pip install -e .
A plain clone checks out release, the stable branch whose code matches these
docs. For the latest unreleased work, switch to the integration branch with
git checkout dev.
Flagship models
LibreYOLO recommends these model families because they offer the best balance and receive the heaviest testing:
- YOLOv9 for CNN-based YOLO models.
- RF-DETR for transformer-based detection and segmentation.
Detection models
LibreYOLO is a YOLO library first. The table below covers the main detection
families. ✓ supported. Empty cells are not currently supported.
| Model family | Inference | Training | Export formats | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Detection | Segmentation | Pose | ONNX | TorchScript | TensorRT | OpenVINO | NCNN | TFLite (LiteRT) | ||
| ⭐ YOLOv9 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| ⭐ RF-DETR | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
| YOLOX | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| YOLO-NAS | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| YOLOv9-E2E | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| YOLOv9-P2 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| YOLOv7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| D-FINE | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| DEIM | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| DEIMv2 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| RT-DETR | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| RT-DETRv2 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| RT-DETRv4 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| EC | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| RTMDet | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| PicoDet | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Beyond detection
The same three-line API covers a lot more than boxes: the checkpoint name selects the task. These families are extras on top of the core library.
All other tasks and their models
- Instance segmentation (promptable): SAM, SAM 2, SAM 3, MobileSAM, EdgeTAM, PicoSAM3, EoMT
- Semantic segmentation: SegFormer, PIDNet, EoMT, DINOv2
- Panoptic segmentation: EoMT
- Oriented boxes (OBB): RF-DETR
- Classification: ResNet, ConvNeXt, MobileNetV4, EfficientNetV2, DINOv2, CLIP, SigLIP2
- Point detection: FOMO, LocateAnything
- Depth estimation: Depth Anything 3, Depth Anything V2, ZipDepth
- Image restoration & super-resolution: NAFNet, Real-ESRGAN, SwinIR
- Background removal (matting): BiRefNet
- OCR: PP-OCR
- Gaze estimation: L2CS
- Open-vocabulary & VLM detection: Grounding DINO, OWLv2, OmDet-Turbo, OV-DEIM, Florence-2, Kosmos-2, Qwen3-VL, InternVL3, LFM2-VL, SmolVLM2, LocateAnything
License
- Code: MIT License
- Weights: Pre-trained weights may inherit licensing from the original source. Check the license in the specific HF repo of weights that you are interested in. LibreYOLO HF models always have a license.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file libreyolo-1.4.0.tar.gz.
File metadata
- Download URL: libreyolo-1.4.0.tar.gz
- Upload date:
- Size: 5.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
33732eb0b5e1e70501dca71bebb532bbcaba9fb8fea48024918df18f90073ace
|
|
| MD5 |
5a2cb15cc1a4a102b31294796e4ed524
|
|
| BLAKE2b-256 |
be4f8cd20f3dde42400feb57242fe345705a72f9b3a78682dd1a5dca15c9856f
|
Provenance
The following attestation bundles were made for libreyolo-1.4.0.tar.gz:
Publisher:
publish.yml on LibreYOLO/libreyolo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
libreyolo-1.4.0.tar.gz -
Subject digest:
33732eb0b5e1e70501dca71bebb532bbcaba9fb8fea48024918df18f90073ace - Sigstore transparency entry: 2234409322
- Sigstore integration time:
-
Permalink:
LibreYOLO/libreyolo@62f8a69ac8ac0e4a48dccd60c4f57f07c4856bdb -
Branch / Tag:
refs/tags/v1.4.0 - Owner: https://github.com/LibreYOLO
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@62f8a69ac8ac0e4a48dccd60c4f57f07c4856bdb -
Trigger Event:
push
-
Statement type:
File details
Details for the file libreyolo-1.4.0-py3-none-any.whl.
File metadata
- Download URL: libreyolo-1.4.0-py3-none-any.whl
- Upload date:
- Size: 6.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
65cdd653ef238bf0a13a3b3ad4d15640df29d36984893d817674d23eeffdd8d7
|
|
| MD5 |
d02a915566a7f05ec8183738f2929def
|
|
| BLAKE2b-256 |
ef024966bf4f23fec52cf52d66c540520278d4b7aa8fd9585e0ab415477a9dd1
|
Provenance
The following attestation bundles were made for libreyolo-1.4.0-py3-none-any.whl:
Publisher:
publish.yml on LibreYOLO/libreyolo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
libreyolo-1.4.0-py3-none-any.whl -
Subject digest:
65cdd653ef238bf0a13a3b3ad4d15640df29d36984893d817674d23eeffdd8d7 - Sigstore transparency entry: 2234410622
- Sigstore integration time:
-
Permalink:
LibreYOLO/libreyolo@62f8a69ac8ac0e4a48dccd60c4f57f07c4856bdb -
Branch / Tag:
refs/tags/v1.4.0 - Owner: https://github.com/LibreYOLO
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@62f8a69ac8ac0e4a48dccd60c4f57f07c4856bdb -
Trigger Event:
push
-
Statement type: