RF-DETR+ Extension Package
Project description
RF-DETR+: Large-Scale Detection Models for RF-DETR
RF-DETR is the core package in the ecosystem. It provides the full training and inference stack, the {Nano, Small, Medium, Large} model lineup, and the APIs most users build on. RF-DETR+ is an extension package for RF-DETR that adds the XLarge and 2XLarge detection models for maximum accuracy.
RF-DETR+ models use a DINOv2 vision transformer backbone at higher resolutions and larger feature dimensions than the core RF-DETR lineup, pushing state-of-the-art accuracy on Microsoft COCO and RF100-VL while retaining real-time inference speeds. Use RF-DETR for the standard model set and RF-DETR+ when you need the highest-accuracy variants.
Install
Install RF-DETR+ in a Python>=3.10 environment with pip. This will also install rfdetr as a dependency, which provides the core APIs and model definitions.
pip install rfdetr-plus
Install from source
pip install git+https://github.com/roboflow/rf-detr-plus.git
Benchmarks
RF-DETR+ XLarge and 2XLarge sit at the top of the RF-DETR accuracy/latency curve, delivering the highest COCO AP scores in the family. All latency numbers were measured on an NVIDIA T4 using TensorRT, FP16, and batch size 1.
| Size | Class | COCO AP50 | COCO AP50:95 | RF100VL AP50 | RF100VL AP50:95 | Latency (ms) | Params (M) | Resolution | Package / License |
|---|---|---|---|---|---|---|---|---|---|
| N | RFDETRNano |
67.6 | 48.4 | 85.0 | 57.7 | 2.3 | 30.5 | 384x384 | rfdetr / Apache 2.0 |
| S | RFDETRSmall |
72.1 | 53.0 | 86.7 | 60.2 | 3.5 | 32.1 | 512x512 | rfdetr / Apache 2.0 |
| M | RFDETRMedium |
73.6 | 54.7 | 87.4 | 61.2 | 4.4 | 33.7 | 576x576 | rfdetr / Apache 2.0 |
| L | RFDETRLarge |
75.1 | 56.5 | 88.2 | 62.2 | 6.8 | 33.9 | 704x704 | rfdetr / Apache 2.0 |
| ⭐ XL | RFDETRXLarge |
77.4 | 58.6 | 88.5 | 62.9 | 11.5 | 126.4 | 700x700 | rfdetr_plus / PML 1.0 |
| ⭐ 2XL | RFDETR2XLarge |
78.5 | 60.1 | 89.0 | 63.2 | 17.2 | 126.9 | 880x880 | rfdetr_plus / PML 1.0 |
Run Models
Install RF-DETR+ to use XL and 2XL models alongside the core RF-DETR lineup:
pip install rfdetr_plus
RF-DETR+ models require you to accept the Platform Model License before use. Once accepted, usage mirrors the standard RF-DETR API -- you import the models from rfdetr_plus and keep using the rfdetr utilities:
import requests
import supervision as sv
from PIL import Image
from rfdetr_plus import RFDETRXLarge
from rfdetr.assets.coco_classes import COCO_CLASSES
model = RFDETRXLarge(accept_platform_model_license=True)
image = Image.open(requests.get("https://media.roboflow.com/dog.jpg", stream=True).raw)
detections = model.predict(image, threshold=0.5)
labels = [f"{COCO_CLASSES[class_id]}" for class_id in detections.class_id]
annotated_image = sv.BoxAnnotator().annotate(image, detections)
annotated_image = sv.LabelAnnotator().annotate(annotated_image, detections, labels)
Train Models
RF-DETR+ models support fine-tuning with the same training API as core RF-DETR. You can train on your own dataset or use datasets from Roboflow Universe.
from rfdetr_plus import RFDETRXLarge
model = RFDETRXLarge(accept_platform_model_license=True)
model.train(dataset_dir="path/to/dataset", epochs=50, lr=1e-4)
Documentation
Visit the RF-DETR documentation website to learn more about training, export, deployment, and the full model lineup.
License
RF-DETR+ code and model checkpoints are licensed under the Platform Model License 1.0 (PML-1.0). See LICENSE for details. These models require a Roboflow account to run and fine-tune.
The core RF-DETR models (Nano through Large) are available under the Apache License 2.0 in the rfdetr package.
Acknowledgements
Our work is built upon LW-DETR, DINOv2, and Deformable DETR. Thanks to their authors for their excellent work!
Citation
If you find our work helpful for your research, please consider citing the following BibTeX entry.
@misc{rf-detr,
title={RF-DETR: Neural Architecture Search for Real-Time Detection Transformers},
author={Isaac Robinson and Peter Robicheaux and Matvei Popov and Deva Ramanan and Neehar Peri},
year={2025},
eprint={2511.09554},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2511.09554},
}
Contribute
We welcome and appreciate all contributions! If you notice any issues or bugs, have questions, or would like to suggest new features, please open an issue or pull request. By sharing your ideas and improvements, you help make RF-DETR better for everyone.
Project details
Release history Release notifications | RSS feed
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 rfdetr_plus-1.0.2.tar.gz.
File metadata
- Download URL: rfdetr_plus-1.0.2.tar.gz
- Upload date:
- Size: 15.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
026c33487a6f3300205b1116b2b210fff346f618b5db056ad42fb6517dce3432
|
|
| MD5 |
dd723d6d05b85a91cd54652a60d95aef
|
|
| BLAKE2b-256 |
0af3f4199916ebe08e1bf6984819c42ad6bddf14e98728520849593abff2dfb3
|
Provenance
The following attestation bundles were made for rfdetr_plus-1.0.2.tar.gz:
Publisher:
publish-release.yml on roboflow/rf-detr_plus
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
rfdetr_plus-1.0.2.tar.gz -
Subject digest:
026c33487a6f3300205b1116b2b210fff346f618b5db056ad42fb6517dce3432 - Sigstore transparency entry: 1253812674
- Sigstore integration time:
-
Permalink:
roboflow/rf-detr_plus@5ac42d618b8f1d10aada9adf1a0a73c83cf5acf9 -
Branch / Tag:
refs/tags/1.0.2 - Owner: https://github.com/roboflow
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-release.yml@5ac42d618b8f1d10aada9adf1a0a73c83cf5acf9 -
Trigger Event:
release
-
Statement type:
File details
Details for the file rfdetr_plus-1.0.2-py3-none-any.whl.
File metadata
- Download URL: rfdetr_plus-1.0.2-py3-none-any.whl
- Upload date:
- Size: 10.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4fa85fcf94e1c529eae4862462b6c15dd9dd882dac728a5a77a616a082cad216
|
|
| MD5 |
f7d79edc63ec0a5198ca3032e7d802dc
|
|
| BLAKE2b-256 |
2f0f8b3d9e0796a9e9d2641fd6be39fb4a8b4aabf6b84d2a543a587d15992ad4
|
Provenance
The following attestation bundles were made for rfdetr_plus-1.0.2-py3-none-any.whl:
Publisher:
publish-release.yml on roboflow/rf-detr_plus
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
rfdetr_plus-1.0.2-py3-none-any.whl -
Subject digest:
4fa85fcf94e1c529eae4862462b6c15dd9dd882dac728a5a77a616a082cad216 - Sigstore transparency entry: 1253812715
- Sigstore integration time:
-
Permalink:
roboflow/rf-detr_plus@5ac42d618b8f1d10aada9adf1a0a73c83cf5acf9 -
Branch / Tag:
refs/tags/1.0.2 - Owner: https://github.com/roboflow
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-release.yml@5ac42d618b8f1d10aada9adf1a0a73c83cf5acf9 -
Trigger Event:
release
-
Statement type: