Open-source Python bindings for the Gemini LeapC API. Allowing developers to use Ultraleaps Hand Tracking technology with Python. Including build instructions and some simple examples to get started with.
To use this plugin you will need the following:
- The latest Gemini Ultraleap Hand Tracking Software. You can get this here.
- An Ultraleap Hand Tracking Camera - follow setup process here.
- Follow one of the Installation workflows listed below.
This module makes use of a compiled module called leapc_cffi. We include some pre-compiled python objects with our
Gemini installation from 5.17 onwards. Supported versions can be found here. If you
have the matching python version and have installed Gemini into the default location you can follow the steps below:
# Create and activate a virtual environment
pip install -r requirements.txt
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
The included pre-compiled modules within our 5.17 release currently only support the following versions of python:
- Windows: Python 3.8
- Linux x64: Python 3.8
- Darwin: Python 3.8
- Linux ARM: Python 3.8, 3.9, 3.10, 3.11
Expanded pre-compiled support will be added soon. However, this does not restrict you to these versions, if you wish to use a different python version please follow the instructions below to compile your own module.
You might not have the correct matching compiled leapc_cffi module for your system, this can cause issues when importing
leap, such as: ModuleNotFoundError: No module named 'leapc_cffi._leapc_cffi'
If you'd like to build your own compiled module, you will still require a Gemini install and a C compiler of your
choice. Follow the steps below:
# Create and activate a virtual environment
pip install -r requirements.txt
python -m build leapc-cffi
pip install leapc-cffi/dist/leapc_cffi-0.0.1.tar.gz
pip install -e leapc-python-api
python examples/tracking_event_example.py
Our vision is to make it as easy as possible to design the best user experience for hand tracking. We learn and are inspired by the creations from our open source community - any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch:
git checkout -b feature/AmazingFeature - Commit your Changes:
git commit -m "Add some AmazingFeature" - Push to the Branch:
git push origin feature/AmazingFeature - Open a Pull Request
Use of the LeapC Python Bindings is subject to the Apache V2 License Agreement.
Our Discord Server, Github Discussions and Developer Forum are places where you are actively encouraged to share your questions, insights, ideas, feature requests and projects.