notaadhil/gesture_meme

Gesture Meme is a Python project that watches your webcam in real-time and displays a meme image whenever it detects a specific face or hand gesture. It uses two computer vision libraries: OpenCV for capturing and displaying video, and MediaPipe for detecting body landmarks. A brief calibration step at startup measures your neutral face so the detection thresholds are adjusted to you personally before it starts recognizing gestures. The project recognizes eight gestures: making a timeout T-shape with two hands, pressing palms together in a prayer gesture, raising or furrowing your eyebrows, sticking your tongue out, touching or biting a finger near your mouth, framing your face with two hands like a cinema shot, holding both hands above your nose, and extending your index and middle fingers. Each gesture is mapped to a specific meme image file in the same folder. The README is brief but complete. Setup involves cloning the repository, placing the meme images alongside the main script, and running the included batch file on Windows. The batch file sets up a virtual environment and installs the correct library versions automatically. The project works on Windows only and requires Python 3.8 through 3.11 because MediaPipe does not yet support Python 3.12 or later. Good lighting is recommended for accurate detection. The license is not mentioned in the README.