bbox-visualizer
January 22, 2026 ยท View on GitHub
This package helps users draw bounding boxes around objects, without doing the clumsy math that you'd need to do for positioning the labels. It also has a few different types of visualizations you can use for labeling objects after identifying them.
The bounding box points are expected in the format: (xmin, ymin, xmax, ymax)
- Documentation: https://bbox-visualizer.readthedocs.io.
- Free software: MIT license
Installation:
pip install bbox-visualizer
Usage:
import bbox_visualizer as bbv

Photos by Joshua Earle, Jonas Weckschmied and Sherzod Max on Unsplash.
| image | function |
|---|---|
![]() | img = bbv.draw_box(img, bbox) img = bbv.add_label(img, label, bbox, top=True) |
![]() | img = bbv.draw_box(img, bbox) img = bbv.add_T_label(img, label, bbox) |
![]() | img = bbv.draw_flag_with_label(img, label, bbox) |
![]() | img = bbv.draw_box(img, bbox) img = bbv.add_label(img, label, bbox, top=False) |
![]() | img = bbv.draw_box(image, bbox, is_opaque=True) img = bbv.add_label(img, label, bbox, draw_bg=False, top=False) |
![]() | img = bbv.draw_multiple_boxes(img, bboxes) img = bbv.add_multiple_labels(img, labels, bboxes) |
![]() | img = bbv.draw_multiple_flags_with_labels(img, labels, bboxes) |
![]() | img = bbv.draw_multiple_boxes(img, bboxes) img = bbv.add_multiple_T_labels(img, labels, bboxes) |
Note: The functions
draw_rectangleanddraw_multiple_rectanglesare also available as aliases fordraw_boxanddraw_multiple_boxesrespectively. Both naming conventions work identically.
There are optional functions that can draw multiple bounding boxes and/or write multiple labels on the same image, but it is advisable to use the above functions in a loop in order to have full control over your visualizations.
- bbv.draw_multiple_boxes(img, bboxes)
- bbv.add_multiple_labels(img, labels, bboxes)
- bbv.add_multiple_T_labels(img, labels, bboxes)
- bbv.draw_multiple_flags_with_labels(img, labels, bboxes)
bboxes and labels are lists in the above examples.
Credits
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.







