Computer Installation
Note
Installation via pip typically requires internet access
FRC-AprilTags requires a Python version greater than 3.7 to be installed on your computer. This package is also not supported on 32-bit installations of Python except on ARM coprocessors. Therefore, you must have a 64-bit python installation on your computer.
Once you have installed Python, you can use pip to install FRC-AprilTags. While it is possible to install without pip, due to its dependencies this is not recommended nor supported.
Warning
On Windows, the Visual Studio 2019 redistributable is required to install this package.
Run the following command from cmd or Powershell to install the frc-apriltags packages:
pip install frc-apriltags
To upgrade, you can run this:
pip install --upgrade frc-apriltags
If you don’t have administrative rights on your computer, either use virtualenv/virtualenvwrapper-win, or or you can install to the user site-packages directory:
pip install --user frc-apriltags
On a macOS system that has pip installed, just run the following command from the Terminal application (may require admin rights):
pip3 install frc-apriltags
To upgrade, you can run this:
pip3 install --upgrade frc-apriltags
If you don’t have administrative rights on your computer, either use virtualenv/virtualenvwrapper, or or you can install to the user site-packages directory:
pip3 install --user frc-apriltags
In order to install one of this packages dependecies, a distro that has glibc 2.35 or newer, and an installer that implements PEP 600, such as pip 20.3 or newer is required. You can check your version of pip with the following command:
pip3 --version
If you need to upgrade your version of pip, it is highly recommended to use a virtual environment.
If you have a compatible version of pip, you can simply run:
pip3 install frc-apriltags
To upgrade, you can run this:
pip3 install --upgrade frc-apriltags
The following Linux distributions are known to work, but this list is not necessarily comprehensive:
Ubuntu 22.04+
Fedora 36+
Arch Linux
If you manage to install the packages and get the following error or something similar, your system is most likely not compatible with RobotPy, one of this packages dependecies:
OSError: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.22' not found (required by /usr/local/lib/python3.7/dist-packages/wpiutil/lib/libwpiutil.so)
Prior to installing this package on an ARM Coprocessor,
it is highly recommended to first install RobotPy using the prebuit wheels
provided at tortall.net.
These wheels can be downloaded by giving the --find-links option to pip:
pip3 install --upgrade --find-links https://tortall.net/~robotpy/wheels/2023/raspbian/ wpilib robotpy-hal robotpy-halsim-gui robotpy-installer robotpy-wpilib-utilities robotpy-wpimath robotpy-wpinet robotpy-wpiutil robotpy robotpy-cscore pyntcore pynetworktables
Warning
g++ and gcc 11 or higher are required to install this package.
Once this is complete, install FRC-AprilTags using pip:
pip3 install frc-apriltags