YOLOv7 - Framework Beyond Detection

Documentation • Installation Instructions • Deployment • Contributing • Reporting Issues

This is the first and only (for now) YOLO family variant with transformers! and more advanced YOLO with multi-tasking such as detect & segmentation at the same time!

🔥🔥🔥 Just another yolo variant implemented based on detectron2. Be note that YOLOv7 doesn't meant to be a successor of yolo family, 7 is just my magic and lucky number. In our humble opinion, a good opensource project must have these features:

It must be reproduceble;
It must be simple and understandable;
It must be build with the weapon of the edge;
It must have a good maintainance, listen to the voice from community;

However, we found many opensource detection framework such as YOLOv5, Efficientdet have their own weakness, for example, YOLOv5 is very good at reproduceable but really over-engineered, too many messy codes. What's more surprisingly, there were at least 20+ different version of re-implementation of YOLOv3-YOLOv4 in pytorch, 99.99% of them were totally wrong, either can u train your dataset nor make it mAP comparable with origin paper.(However, doesn't mean this work is totally right, use at your own risk.)

That's why we have this project! It's much more simpler to experiment different ARCH of YOLO build upon detectron2 with YOLOv7! Most importantly, more and more decent YOLO series model merged into this repo such as YOLOX (most decent in 2021). We also welcome any trick/experiment PR on YOLOv7, help us build it better and stronger!!. Please star it and fork it right now!.

The supported matrix in YOLOv7 are:

what's more, there are some features awesome inside repo:

Almost all models can export to onnx;
Supports TensorRT deployment for DETR and other transformer models;
It will integrate with wanwu, a torch-free deploy framework run fastest on your target platform.

Help wanted! If you have spare time or if you have GPU card, then help YOLOv7 become more stronger! Here is the guidance of contribute:

Claim task: I have some ideas but do not have enough time to do it, if you want implement it, claim the task, I will give u fully advise on how to do, and you can learn a lot from it;
Test mAP: When you finished new idea implementation, create a thread to report experiment mAP, if it work, then merge into our main master branch;
Pull request: YOLOv7 is open and always tracking on SOTA and light models, if a model is useful, we will merge it and deploy it, distribute to all users want to try.

Here are some tasks need to be claimed:

VAN: Visual Attention Network, paper, VAN-Segmentation, it was better than Swin and PVT and DeiT:
- D2 VAN backbone integration;
- Test with YOLOv7 arch;
ViDet: code, this provides a realtime detector based on transformer, Swin-Nano mAP: 40, while 20 FPS, it can be integrated into YOLOv7;
- Integrate into D2 backbone, remove MSAtten deps;
- Test with YOLOv7 or DETR arch;
DINO: 63.3mAP highest in 2022 on coco. https://github.com/IDEACVR/DINO
- waiting for DINO opensource code.
ConvNext: https://github.com/facebookresearch/ConvNeXt, combined convolution and transformer.

💁‍♂️ Results

YOLOv7 Instance	Face & Detection

🤔 Features

Some highlights of YOLOv7 are:

A simple and standard training framework for any detection && instance segmentation tasks, based on detectron2;
Supports DETR and many transformer based detection framework out-of-box;
Supports easy to deploy pipeline thought onnx.
This is the only framework support YOLOv4 + InstanceSegmentation in single stage style;
Easily plugin into transformers based detector;

We are strongly recommend you send PR if you have any further development on this project, the only reason for opensource it is just for using community power to make it stronger and further. It's very welcome for anyone contribute on any features!

😎 Rules

There are some rules you must follow to if you want train on your own dataset:

Rule No.1: Always set your own anchors on your dataset, using tools/compute_anchors.py, this applys to any other anchor-based detection methods as well (EfficientDet etc.);
Rule No.2: Keep a faith on your loss will goes down eventually, if not, dig deeper to find out why (but do not post issues repeated caused I might don't know either.).
Rule No.3: No one will tells u but it's real: do not change backbone easily, whole params coupled with your backbone, dont think its simple as you think it should be, also a Deeplearning engineer is not an easy work as you think, the whole knowledge like an ocean, and your knowledge is just a tiny drop of water...
Rule No.4: must using pretrain weights for transoformer based backbone, otherwise your loss will bump;

Make sure you have read rules before ask me any questions.

🆕 News!

2021.09.16: First transformer based DETR model added, will explore more DETR series models;
2021.08.02: YOLOX arch added, you can train YOLOX as well in this repo;
2021.07.25: We found YOLOv7-Res2net50 beat res50 and darknet53 at same speed level! 5% AP boost on custom dataset;
2021.07.04: Added YOLOF and we can have a anchor free support as well, YOLOF achieves a better trade off on speed and accuracy;
2021.06.25: this project first started.
more

🧑‍🦯 Installation && Quick Start

See install.md

😎 Train

For training, quite simple, same as detectron2:

python train_net.py --config-file configs/coco/darknet53.yaml --num-gpus 8

If you want train YOLOX, you can using config file configs/coco/yolox_s.yaml. All support arch are:

YOLOX: anchor free yolo;
YOLOv7: traditional yolo with some explorations, mainly focus on loss experiments;
YOLOv7P: traditional yolo merged with decent arch from YOLOX;
YOLOMask: arch do detection and segmentation at the same time (tbd);
YOLOInsSeg: instance segmentation based on YOLO detection (tbd);

🥰 Demo

Run a quick demo would be like:

python3 demo.py --config-file configs/wearmask/darknet53.yaml --input ./datasets/wearmask/images/val2017 --opts MODEL.WEIGHTS output/model_0009999.pth

an update based on detectron2 newly introduced LazyConfig system, run with a LazyConfig model using:

python3 demo_lazyconfig.py --config-file configs/new_baselines/panoptic_fpn_regnetx_0.4g.py --opts train.init_checkpoint=output/model_0004999.pth

Export ONNX && TensorRTT && TVM

detr:

python export_onnx.py --config-file detr/config/file

this works has been done, inference script included inside tools.

AnchorDETR:

anchorDETR also supported training and exporting to ONNX.

More Advanced YOLO

Here we show some highlights on multi-tasking:

Performance

Here is a dedicated performance compare with other packages.

Some Tiny Object Datasets supported

Wearmask: support VOC, Yolo, coco 3 format. You can using coco format here. Download from: 链接: https://pan.baidu.com/s/1ozAgUFLqfTXLp-iOecddqQ 提取码: xgep . Using configs/wearmask to train this dataset.
more: to go.

Detection Results

Dicussion Group

Wechat	QQ

if wechat expired, please contact me update via github issue. group for general discussion, not only for yolov7.

Some Exp Visualizations

GridMask

Our GridMask augmentation also supports 2 modes.
Mosaic

Our Mosaic support any size and any any image numbers!

new: we merged another mosiac implementation from YOLOX, this version will do random pespective:

youtang1993/yolov7