Robot hand

Hand tracking demo: reads the webcam, draws MediaPipe hand landmarks, and shows finger states and angles on screen.

Quick start

1. Clone this repo and open a terminal in the project folder.

2. Install dependencies with uv. The project uses Python 3.13.

   uv sync

3. Start the app

   uv run python main.py

4. Quit - press q in the video window.

Camera not working?

The script opens camera index 2 by default using Apple's AVFoundation backend (cv2.CAP_AVFOUNDATION), which matches typical setups on macOS. If you get a black window or an error, try a different index with the --camera flag:

uv run python main.py --camera 0