yolov3 README

The project's README from github.com/ultralytics/yolov3. As one markdown file: README.md.

Ultralytics YOLOv3 banner

中文 | 한국어 | 日本語 | Русский | Deutsch | Français | Español | Português | Türkçe | Tiếng Việt | العربية

YOLOv3 CI Docker Pulls Discord Ultralytics Forums Ultralytics Reddit
Open In Colab

Ultralytics YOLOv3 is a PyTorch implementation of the YOLOv3 (You Only Look Once, version 3) real-time object detection model. YOLOv3 frames detection as a single regression problem, predicting bounding boxes and class probabilities directly from full images in one forward pass — making it fast, accurate, and straightforward to train and deploy.

This repository packages the three classic YOLOv3 detection models — YOLOv3, YOLOv3-SPP, and YOLOv3-tiny — with training, validation, inference, and export tooling, and reuses shared utilities from the ultralytics package.

Find detailed guidance in the Ultralytics YOLOv3 Docs. Get support via GitHub Issues, and join the conversation on Discord, Reddit, and the Ultralytics Forums.

For commercial use, request an Enterprise License at Ultralytics Licensing.

Ultralytics GitHub space Ultralytics LinkedIn space Ultralytics Twitter space Ultralytics YouTube space Ultralytics TikTok space Ultralytics BiliBili space Ultralytics Discord

📚 Documentation

See the Ultralytics YOLOv3 Docs for full documentation. The quickstart examples below cover installation, inference, and training with this repository.

Install

Clone the repository and install the dependencies from requirements.txt in a Python>=3.8.0 environment with PyTorch>=1.8.

# Clone the YOLOv3 repository
git clone https://github.com/ultralytics/yolov3

# Navigate to the cloned directory
cd yolov3

# Install required packages
pip install -r requirements.txt
Inference with PyTorch Hub

Load YOLOv3 directly through PyTorch Hub. Weights download automatically on first use.

import torch

# Load a YOLOv3 model (choices: 'yolov3', 'yolov3_spp', 'yolov3_tiny')
model = torch.hub.load("ultralytics/yolov3", "yolov3", pretrained=True)

# Run inference on an image (local file, URL, PIL image, OpenCV frame, or numpy array)
results = model("https://ultralytics.com/images/zidane.jpg")

# Inspect the results
results.print()  # print detections to the console
results.show()  # display the annotated image
results.save()  # save the annotated image to runs/detect/exp
Inference with detect.py

detect.py runs inference on a wide range of sources, downloading models automatically and saving results to runs/detect.

python detect.py --weights yolov3.pt --source 0                              # webcam
python detect.py --weights yolov3.pt --source img.jpg                        # image
python detect.py --weights yolov3.pt --source vid.mp4                        # video
python detect.py --weights yolov3.pt --source screen                         # screenshot
python detect.py --weights yolov3.pt --source path/                          # directory
python detect.py --weights yolov3.pt --source 'path/*.jpg'                   # glob
python detect.py --weights yolov3.pt --source 'rtsp://example.com/media.mp4' # RTSP, RTMP, HTTP stream
Training

Train YOLOv3 on the COCO dataset. Models and datasets download automatically. Use the largest --batch-size your hardware allows.

# Train YOLOv3-tiny
python train.py --data coco.yaml --epochs 300 --weights '' --cfg yolov3-tiny.yaml --batch-size 64

# Train YOLOv3
python train.py --data coco.yaml --epochs 300 --weights '' --cfg yolov3.yaml --batch-size 32

# Train YOLOv3-SPP
python train.py --data coco.yaml --epochs 300 --weights '' --cfg yolov3-spp.yaml --batch-size 16

Validate accuracy with python val.py --weights yolov3.pt --data coco.yaml, and export to other formats (TorchScript, ONNX, OpenVINO, TensorRT, CoreML, and PaddlePaddle) with python export.py --weights yolov3.pt --include onnx.

Tutorials

These guides cover the shared Ultralytics training framework and apply to YOLOv3:

🧠 Architecture

YOLOv3 builds detection on a few core ideas that make it both accurate and fast:

The repository ships three variants of this architecture:

Models are defined declaratively in models/*.yaml and built by parse_model() in models/yolo.py, so the architecture can be inspected and modified without writing Python.

🏋️ Pretrained Checkpoints

All three models are trained on COCO (80 classes) and download automatically from the YOLOv3 release assets on first use.

Model Description
yolov3-tiny.pt Lightweight two-scale model — the fastest option, ideal for CPU and edge devices.
yolov3.pt The original Darknet-53 model — a strong balance of speed and accuracy.
yolov3-spp.pt Adds Spatial Pyramid Pooling for a larger receptive field and improved accuracy.

🧩 Integrations

Ultralytics integrates with leading AI platforms to extend dataset labeling, training, visualization, and model management. Explore how partners such as Weights & Biases, Comet ML, Roboflow, and Intel OpenVINO can streamline your workflow at Ultralytics Integrations.

Ultralytics active learning integrations

🤔 Why YOLOv3?

YOLOv3 was a landmark in real-time object detection and remains a dependable, well-understood baseline:

For the broader family of Ultralytics YOLO models, see the Ultralytics repository.

☁️ Environments

Get started quickly with pre-configured environments. Click an icon below for setup details.

Run on Gradient Open In Colab Open In Kaggle Docker Image AWS Marketplace GCP Quickstart

🤝 Contribute

Contributions are welcome! Please see the Contributing Guide to get started, and share your feedback through the Ultralytics Survey. Thank you to all our contributors!

Ultralytics open-source contributors

📜 License

Ultralytics offers two licensing options:

📧 Contact

For bug reports and feature requests, please use GitHub Issues. For questions and discussion, join our Discord, Reddit, and the Ultralytics Forums.


Ultralytics GitHub space Ultralytics LinkedIn space Ultralytics Twitter space Ultralytics YouTube space Ultralytics TikTok space Ultralytics BiliBili space Ultralytics Discord

yolov3 (ultralytics/yolov3)

Searching Database…

10.6K ·GitHub
Что это такое?Реализация детектора объектов реального времени YOLOv3 от Ultralytics на PyTorch: в неё входят три варианта модели — YOLOv3, YOLOv3-SPP и YOLOv3-tiny — а также инструменты для обучения, валидации, инференса и экспорта в разные форматы.
Это библиотека, которую я импортирую, или набор скриптов для запуска?И то и другое. Модели можно загрузить в коде через PyTorch Hub, либо запускать готовые скрипты из командной строки: detect.py для инференса, а также train.py, val.py и export.py.
Как его запустить?Склонируйте репозиторий и установите зависимости из requirements.txt в окружении с Python>=3.8.0 и PyTorch>=1.8, затем запускайте скрипты или загружайте модели через PyTorch Hub.
Что должно быть установлено, чтобы им пользоваться?Достаточно Python 3.8+ и PyTorch 1.8+; остальное ставится из requirements.txt, а предобученные веса и датасеты скачиваются автоматически — без API-ключей и регистрации.
Стоит ли мне всё ещё использовать именно YOLOv3?Здесь классическая, хорошо изученная архитектура YOLOv3 — надёжный базовый вариант. Но если нужны более новые и широкие модели семейства YOLO от Ultralytics, лучше взять основной репозиторий Ultralytics.
Он запустится на моём Windows или это только для Linux?Это обычный Python и PyTorch, так что всё одинаково работает на Linux, macOS и Windows.
Всё работает локально на моём железе?Да — это локальный код на Python/PyTorch без облачной составляющей; обучение и инференс идут на вашем компьютере.
Можно ли использовать его в коммерческом продукте?По стандартной лицензии — нет: AGPL-3.0 ориентирована на исследования и совместную разработку. Для коммерческого использования нужна платная Enterprise License от Ultralytics.
Чем отличаются YOLOv3, YOLOv3-SPP и YOLOv3-tiny?YOLOv3 — полная модель на Darknet-53, лучший баланс скорости и точности. YOLOv3-SPP добавляет блок Spatial Pyramid Pooling, который расширяет рецептивное поле и немного повышает точность. YOLOv3-tiny — компактная модель с двумя масштабами, самый быстрый вариант, оптимизированный под CPU и edge-устройства.
Что он распознаёт сразу, без настройки?Поставляемые чекпоинты предобучены на COCO с 80 классами, поэтому эти объекты распознаются сразу, без какого-либо обучения с вашей стороны.
Могу ли я обучить его на своём датасете?Да — гайд Train Custom Data проведёт вас через весь процесс, а общий тренировочный фреймворк Ultralytics добавляет обучение на нескольких GPU, автоматический подбор гиперпараметров, test-time аугментацию, ансамблирование моделей и transfer learning с заморозкой слоёв.
В какие форматы можно экспортировать обученную модель для развёртывания?export.py поддерживает TorchScript, ONNX, OpenVINO, TensorRT, CoreML и PaddlePaddle — например: python export.py --weights yolov3.pt --include onnx.
Size
11.1 MB
Stars
10.6K
Age
8y
Commits · 90 Days