Last tested 09/10-2025 on windows and mac
Open-source Python bindings. Allowing developers to use Ultraleaps Hand Tracking technology with Python. Including build instructions and some simple examples to get started with.
Difficulty 5/5, but when it is setup and working, its easy to program custom programs! The code is from another repository, but it was outdated so it didn't work for macOS with the hyperion software, but this updated repository should work for mac and windows!
To use this plugin you will need the following:
- The latest Hyperion Ultraleap Hand Tracking Software. You can get this here.
- An Ultraleap Hand Tracking Camera - follow setup process here.
- Follow the Installation workflows listed below.
# Create and activate a virtual environment
# on mac you do it like this:
python3 -m venv .venv
source .venv/bin/activate
# windows users, find a guide online
# after follow these:
pip install -r requirements.txt
python -m build leapc-cffi
# if the build gives an error, try to google it, but it should not give errors on mac
pip install leapc-cffi/dist/leapc_cffi-0.0.1.tar.gz
pip install -e leapc-python-api
python examples/tracking_event_example.py
This module assumes that you have the Leap SDK installed in the default location. If this is not the case
for you, you can use an environment variable to define the installation location. Define the environment variable
LEAPSDK_INSTALL_LOCATION to the path of the LeapSDK folder, if you have installed to a custom location or moved it
somewhere else.
Example:
export LEAPSDK_INSTALL_LOCATION="C:\Program Files\CustomDir\Ultraleap\LeapSDK"
By default, this path is the following for each operating system:
- Windows:
C:/Program Files/Ultraleap/LeapSDK - Linux x64:
/usr/lib/ultraleap-hand-tracking-service - Linux ARM:
/opt/ultraleap/LeapSDK - Darwin:
/Applications/Ultraleap Hand Tracking.app/Contents/LeapSDK
you need tools to build https://stackoverflow.com/questions/40504552/how-to-install-visual-c-build-tools
Use of the LeapC Python Bindings is subject to the Apache V2 License Agreement.