https://github.com/krishbharadwaj5678/handdrive

Control Hill Climb Racing using hand gestures with real time webcam detection. Open your hand to accelerate, close your fist to stop and reverse the car.
https://github.com/krishbharadwaj5678/handdrive

artificial-intelligence computer-vision cvzone game-automation game-development gesture-recognition github hill-climbing machine-learning mediapipe mediapipe-hands opencv pyautogui python python-game python3

Last synced: 27 days ago
JSON representation

Control Hill Climb Racing using hand gestures with real time webcam detection. Open your hand to accelerate, close your fist to stop and reverse the car.

• Host: GitHub
• URL: https://github.com/krishbharadwaj5678/handdrive
• Owner: KrishBharadwaj5678
• Created: 2025-05-18T08:19:11.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2026-04-28T08:10:57.000Z (about 1 month ago)
• Last Synced: 2026-04-28T10:11:53.828Z (about 1 month ago)
• Topics: artificial-intelligence, computer-vision, cvzone, game-automation, game-development, gesture-recognition, github, hill-climbing, machine-learning, mediapipe, mediapipe-hands, opencv, pyautogui, python, python-game, python3
• Language: Python
• Homepage:
• Size: 13.6 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# ✋ HandDrive

Welcome to **HandDrive**, a Python based computer vision project that lets you control the car in **Hill Climb Racing** using hand gestures.

![HandDriveDemo](https://github.com/KrishBharadwaj5678/HandDrive/raw/main/HandDriveDemo.gif)

## 🧠 Features

| Feature                                  | Description                                                        |

| ---------------------------------------- | ------------------------------------------------------------------ |

| 🖐️ **Real time hand gesture detection** | Uses **MediaPipe** for fast and efficient hand tracking            |

| 🚗 **Intuitive gesture controls**        | 🖐️ **Open Hand** – Triggers the **Accelerate** command  
 ✊ **Closed Hand** – Triggers the **Brake** command |

| 🕹️ **Game automation**                   | Designed for **Hill Climb Racing**                                 |

| 🖥️ **Webcam based control**              | No additional hardware required - just a webcam                    |

| 🎯 **Accurate finger detection**         | Performs well even under varied lighting conditions                |

| 🔄 **Hands free experience**             | Play the game without touching keyboard or mouse                   |

| 📊 **Real-time visual feedback**         | Displays hand landmarks and gesture detection live                 |

---

## 🛠️ Tech Stack

| Technology                                              | Description                                    |

| ------------------------------------------------------- | ---------------------------------------------- |

| 🐍 **Python 3**                                         | Core programming language used for the project |

| 🤖 **MediaPipe**                                        | Real time hand and finger tracking             |

| 🖥️ **OpenCV**                                           | For webcam access and image/video processing   |

| 🧰 **CVZone**                                           | Simplifies working with OpenCV and MediaPipe   |

| 🎮 **pyautogui**                                        | Simulates keyboard presses to control the game |

---

## 🚀 How It Works

1. 🖐️ **Open Hand (All fingers extended)**

   → Simulates pressing the **accelerate** key to move the car **forward**.

2. ✊ **Closed Fist (All fingers folded)**

   → Simulates pressing the **brake** key to **stop** the car and move it **backward**.

---

## 📦 Installation

### 1️⃣ Clone the Repository

   ```bash

   git clone https://github.com/KrishBharadwaj5678/HandDrive.git

   ```

### 2️⃣ Navigate to the Folder

   ```bash

   cd HandDrive

   ```

### 3️⃣ Install the Dependencies

   ```bash

   pip install -r requirements.txt

   ```

### 4️⃣ Run the Project

   ```bash

   python main.py

   ```

---

## Contributing 🤝

Want to contribute? Here's how:

1. 🍴 Fork the repository.

2. 🌿 Create a new branch (`git checkout -b feature-name`).

3. ✍️ Make your changes and commit them (`git commit -am 'Add feature-name'`).

4. 🚀 Push to your branch (`git push origin feature-name`).

5. 🔄 Submit a pull request to merge into the main branch.