AeroPuzzle

AeroPuzzle is a real-time gesture-controlled sliding puzzle game built with Computer Vision and MediaPipe hand tracking. Capture an image from your webcam and solve the puzzle using only hand gestures—no mouse or touch input required.

---

Quick Start

Install

pip install aeropuzzle

Run

python -m aeropuzzle

---

Features

• 🖐️ Gesture-controlled gameplay using hand tracking
• 📷 Create puzzles directly from your webcam feed
• 🎯 Pinch gestures to grab and move puzzle pieces
• ⚡ Smooth cursor movement with adaptive filtering
• 🎨 Modern in-game HUD with timer and status indicators
• 🏆 Victory screen with completion time
• 🚪 Automatically closes after puzzle completion

---

How to Play

1. Launch the game:

python -m aeropuzzle

2. Allow access to your webcam.

3. Position yourself in front of the camera.

4. Use your hand gestures to capture an image.

5. Solve the sliding puzzle by:

   • Moving your hand to control the cursor
   • Pinching to grab a tile
   • Dragging it into position
   • Releasing to swap tiles

6. Complete the puzzle to view your finishing time.

---

Installation

Install from PyPI

pip install aeropuzzle

Install from source

git clone https://github.com/Aarthirt14/AeroPuzzle.git

cd AeroPuzzle

pip install .

---

Requirements

• Python 3.10+
• Webcam

The following dependencies are installed automatically:

• OpenCV
• MediaPipe
• NumPy
• Pillow

---

Tech Stack

Component	Technology
Language	Python
Computer Vision	OpenCV
Hand Tracking	MediaPipe
Image Processing	Pillow
Numerical Computing	NumPy

---

Development

Clone the repository:

git clone https://github.com/Aarthirt14/AeroPuzzle.git

cd AeroPuzzle

Install in editable mode:

pip install -e .

Build the package:

pip install build

python -m build

Upload to PyPI:

pip install twine

python -m twine upload dist/*

---

Project Structure

AeroPuzzle/
│
├── aeropuzzle/
│   ├── __init__.py
│   ├── __main__.py
│   └── ...
│
├── pyproject.toml
├── README.md
└── LICENSE

---

PyPI

Install directly from PyPI:

pip install aeropuzzle

Project page:

https://pypi.org/project/aeropuzzle/

---

GitHub Repository

https://github.com/Aarthirt14/AeroPuzzle

---

License

This project is licensed under the MIT License.

---

Author

Aarthi Suresh

Built to explore Computer Vision, MediaPipe hand tracking, and natural gesture-based interaction through an interactive puzzle game.