How can we help you today?
Quick Start & Installation
The easiest way to get started is by downloading the Windows Installer (.exe) from the Community page or Setup Guide. It bundles everything you need—no coding required.
2. Run the installer and agree to terms
3. Launch "GestureWave AI" from your start menu or desktop shortcut!
For advanced Python users running from source, please clone the GitHub repository and run pip install -r requirements.txt. Then execute python app.py in your terminal.
Recording Custom Gestures
GestureWave AI allows you to record custom hand poses which bind to system actions. Currently, Gesture_1 is mapped to instantly open your default web browser to LinkedIn.
- Click Start Tracking in the main launcher tab.
- Hold your hand up to the camera in the new pose you want to store (e.g., three fingers up).
- While holding still, press the r key on your keyboard.
- Wait for the 3-second countdown on screen to complete.
- Your pose is now saved. Next time you make that exact pose, LinkedIn will launch!
Troubleshooting: Webcam Not Found
If the application starts but the camera preview window does not open, or if the status says "No Hand Detected" even when your hand is up:
- Ensure no other applications (like Zoom or Teams) are currently locking your webcam.
- Navigate to the Settings tab inside the Launcher.
- Change the Camera Index from
0to1or2based on your USB configuration. - Click Apply Settings and restart the tracking.
Troubleshooting: App Immediate Crash
If you are running the project from source and receive an ImportError: numpy.core.multiarray, this happens if your system's NumPy version is incompatible with MediaPipe's compilation.
We highly recommend strictly pinning your NumPy. Execute this command in your terminal manually: pip install "numpy<2"
This will safely downgrade your numpy installation below v2.0 to resolve the architecture conflict.
Still need help?
Our community forum and developers are highly active and waiting to help you optimize your gesture engine setup.