Skip to main content

april_vision

Lint & build PyPI version MIT license

A fiducial marker system used by Student Robotics. Uses april tag markers to provide detection, pose and distance estimation for these markers.

Installation

This library requires OpenCV but the default installation does not install OpenCV. There are a few different versions of OpenCV with different install sizes, to install the default package without OpenCV, run the following command.

pip install april-vision

To install the lightweight headless version OpenCV install the library with the following command.

pip install april-vision[opencv]

If you want to perform some of the more advanced features of the CLI (live view of the camera) you need the full version of OpenCV. The CLI dependecies can be installed with the following command.

pip install april-vision[cli]

Then the full version of OpenCV can then be installed with the following command.

pip install opencv-python>=4.8

All the versions of OpenCV (standard, headless and contrib) clash so you should only have one installed.

Example

from april_vision.examples.camera import setup_cameras

# Markers 0-100 are 80mm in size
tag_sizes = {
    range(0, 100): 80
}

# Returns a dict of index and camera
cameras = setup_cameras(tag_sizes)

if len(cameras) == 0:
    print("No cameras found")

for serial, cam in cameras.items():
    print(cam.model, serial)
    print(cam.see())

Tools

When installed april_vision can be used on the command line providing the following list of useful tools. Each of the tools contain help text on correct usage accessed via the -h argument.

annotate_image
annotate_video
calibrate
live
marker_generator
vision_debug
tools
    family_details
    list_cameras

Metadata

Release files for april-vision 3.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for april-vision 3.1.0
File Size Uploaded Provenance
april_vision-3.1.0.tar.gz 683.0 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for april-vision 3.1.0
File Interpreter ABI Platform
april_vision-3.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 753.3 kB

Release files / april_vision-3.1.0.tar.gz

Download URL april_vision-3.1.0.tar.gz
Size 683.0 kB
Tags Source
SHA-256 checksum
How to use checksums
fa709d3f0eead3aa9b3f0946389f3e8525da117a0754b12db27f4d8100c82e65
BLAKE2b-256 checksum
How to use checksums
81632a66d3e1fadfb1659c16a5a64cf74260c58576095862ad0d08ef9cab0f71
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 29, 2026.

Transparency log

Release files / april_vision-3.1.0-py3-none-any.whl

Download URL april_vision-3.1.0-py3-none-any.whl
Size 70.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
590c45130d24d87fdb7a3456451cc43be6e6150b90217b25f67ba3a2dac0fd8b
BLAKE2b-256 checksum
How to use checksums
754d356f5c2a7db5566f159f05da92f0409e0e587b1ef6cca26c50db0f0e2991
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 29, 2026.

Transparency log

Security for april-vision 3.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for april_vision-3.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page