Practical overview
When it fits
Use it when you want a repository-based path from image annotation through custom YOLOv3 training to inference, or when you want to try the included cat-face detection example.
Who it is for
- Developers and learners building a YOLOv3 detector for a custom image dataset.
- Users who want a guided annotation, training and inference workflow.
Documented uses
- Annotate images for an object-detection dataset using VoTT.
- Train a custom YOLOv3 detector from annotated images and pre-trained weights.
- Run inference on new images or videos.
- Try the included cat-face detector and save bounding-box results.
Requirements & limits
The repository is public and described as open source. Its README displays a CC BY 4.0 license badge.
- The README specifies Python 3.6 or 3.7 and identifies TensorFlow 2.3 and Keras 2.4.
- A CUDA-capable GPU is recommended for faster training; Google Colab can skip most setup.
- The documented training workflow depends on annotated images and downloaded pre-trained weights.
- Weights & Biases experiment tracking is optional and requires its own account and API key.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run the included cat-face inference example
Generate bounding-box results for the repository’s sample cat images.
Before you start
- Python 3.6 or 3.7
- A cloned repository and its required packages installed in a virtual environment
Steps
Open a terminal in the repository’s root folder with the virtual environment active.
Run the command below.
python Minimal_Example.py
Expected outcome
The example writes annotated test images with bounding boxes and confidence scores, along with a Detection_Results.csv file.
Guide limitations
- This is inference with the included cat-face detector, not training a custom model.
- The README reports typical CPU inference speed of approximately two images per second.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 22 October 2026
- Original website title
- AntonMu/TrainYourOwnYOLO · Official homepage title · retained in its source language

