Skip to main content

LibreYOLO

English | 简体中文

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).

Documentation PyPI PyPI Downloads Hugging Face Benchmarks LinkedIn License

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.

LibreYOLO Detection Example

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

libreyolo-1.4.0.tar.gz (5.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

libreyolo-1.4.0-py3-none-any.whl (6.1 MB view details)

Uploaded Python 3

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

Hashes for libreyolo-1.4.0.tar.gz
Algorithm Hash digest
SHA256 33732eb0b5e1e70501dca71bebb532bbcaba9fb8fea48024918df18f90073ace
MD5 5a2cb15cc1a4a102b31294796e4ed524
BLAKE2b-256 be4f8cd20f3dde42400feb57242fe345705a72f9b3a78682dd1a5dca15c9856f

See more details on using hashes here.

Provenance

The following attestation bundles were made for libreyolo-1.4.0.tar.gz:

Publisher: publish.yml on LibreYOLO/libreyolo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for libreyolo-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 65cdd653ef238bf0a13a3b3ad4d15640df29d36984893d817674d23eeffdd8d7
MD5 d02a915566a7f05ec8183738f2929def
BLAKE2b-256 ef024966bf4f23fec52cf52d66c540520278d4b7aa8fd9585e0ab415477a9dd1

See more details on using hashes here.

Provenance

The following attestation bundles were made for libreyolo-1.4.0-py3-none-any.whl:

Publisher: publish.yml on LibreYOLO/libreyolo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.5.0

2 files

This release

1.4.0 This release

2 files

1.3.1

2 files

1.3.0

2 files

1.2.0

2 files

1.1.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page