Cybernetic-AR-HUD

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

Cybernetic-AR-HUD

★ 16 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🤖 Cybernetic AR HUD - Real-Time Face & Hand Tracking

**Created by [@imluban](https://github.com/imluban)**

a futuristic cyberpunk-style AR/HUD overlay system that tracks your face and hand gestures in real-time!

---

## 👨‍💻 **Creator & Owner**

**Made with ❤️ by [Luban Noor (@imluban)](https://github.com/imluban)**

- **GitHub:** [@imluban](https://github.com/imluban)
- **Project Owner:** Luban Noor
- **Original Creator:** [@imluban](https://github.com/imluban)

> 🚨 **Please give credit when using or sharing this project!** 
> 
> If you use this code, fork it, or create content with it, please mention:
> - **Original Creator:** [@imluban](https://github.com/imluban)
> - **GitHub Repository:** [Link to this repo]
> - **Give it a ⭐ if you found it awesome!**

---

## 🚀 Features

- **Real-time face mesh tracking** with MediaPipe
- **Hand gesture recognition** (Open Palm, Fist, Pinch)
- **Futuristic HUD overlays** with cyberpunk aesthetics
- **Neural network visualization** (left side wireframe)
- **Evolution progress tracking** ("cyborg evolution: X% complete")
- **Biometric scanning effects** with animated crosshairs
- **Circuit overlays** that react to gestures
- **System status panels** with real-time data
- **Smooth animations** and glowing effects
- **FPS counter** and performance monitoring

## 🎮 Gesture Controls

| Gesture | Effect |
|---------|--------|
| **Open Palm** 🖐️ | Glowing circuit overlays around hands |
| **Fist** ✊ | Progress bar: "cyborg evolution: X% complete" |
| **Pinch** 🤏 | Face scanning animation with crosshairs |

## 🛠️ Installation

### Prerequisites
- Python 3.9-3.11
- Webcam/Camera
- Windows/Mac/Linux

### Quick Setup

1. **Clone/Download** the Project

**Option A: Using Git (recommended)**

Open your terminal or command prompt and run:
   ```bash
   git clone https://github.com/imluban/Cybernetic-AR-HUD.git

cd Cybernetic-AR-HUD
   ```

**Option B: Download ZIP**

Click Code → Download ZIP on GitHub and extract it to a folder.

2. **Install dependencies:**
   My project uses Python and specific libraries.

From inside the project folder, run:

```bash
   pip install -r requirements.txt
   ```

**If that fails or you want control over versions:**

```bash
   pip install opencv-python==4.8.1.78
   pip install mediapipe==0.10.5
   pip install numpy==1.24.3
   pip install pygame==2.5.2
   ```

This aligns with what the README specifies, these libraries power the       face/hand tracking and the HUD overlays.

3. **Run the application:**

Once dependencies are installed:
   ```bash
   python main.py
   ```
   This launches the augmented reality HUD system. You need a webcam connected (laptop camera or USB webcam).

## 🎯 Usage

1. **Launch the app:**
   ```bash
   python main.py
   ```

2. **Position yourself** in front of your webcam

3. **Show hand gestures** to activate different HUD effects:
   - Hold up your **open palm** → See glowing circuits
   - Make a **fist** → Watch evolution progress increase
   - **Pinch** with thumb & index → Activate face scanning

4. **Press 'q'** to quit safely

## 📁 Project Structure

```
Cybernetic AR HUD/
├── main.py              # Main application entry point
├── hud.py               # HUD drawing and visual effects
├── gestures.py          # Hand gesture recognition logic  
├── utils.py             # FPS counter and helper functions
├── requirements.txt     # Python dependencies
├── README.md           # This file
└── assets/             # Optional fonts/textures
```

## ⚙️ Configuration

### Performance Tuning
- Default resolution: 1280x720
- Target FPS: 30+
- Detection confidence: 0.5
- Tracking confidence: 0.5

### Customization
Edit values in `main.py`:
```python
# Adjust camera resolution
cap.set(cv2.CAP_PROP_FRAME_WIDTH, 1280)  
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 720)

# Modify detection confidence
min_detection_confidence=0.5
min_tracking_confidence=0.5
```

## 🎨 Visual Effects

### Neural Network (Left Side)
- Animated wireframe network
- Pulsing connections
- Data flow indicators
- Matches reference image style

### Progress Bars (Right Side) 
- "cyborg evolution: X% complete"
- "borg evolution level: X% complete"  
- Animated scan lines
- Orange/cyan color scheme

### Face Scanning
- Real-time crosshair tracking
- Animated scan lines
- "FACIAL RECOGNITION ACTIVE" text
- Red targeting overlay

### Hand Circuits
- Radiating connection lines
- Pulsing circuit nodes
- Central hub visualization
- Responds to open palm gesture

## 🐛 Troubleshooting

### Camera Issues
```bash
# Test camera access
python -c "import cv2; cap = cv2.VideoCapture(0); print('Camera OK' if cap.read()[0] else 'Camera Error')"
```

### Performance Issues
- Lower camera resolution in `main.py`
- Reduce detection confidence
- Close other camera applications
- Use better lighting

### Import Errors
```bash
# Reinstall dependencies
pip uninstall opencv-python mediapipe numpy pygame
pip install -r requirements.txt
```

### Windows Specific
- Install Visual C++ Redistributable if OpenCV fails
- Try `pip install --upgrade pip` first

## 📱 System Requirements

- **CPU:** Multi-core processor (Intel i5+ or AMD equivalent)
- **RAM:** 4GB+ recommended  
- **Camera:** Any USB webcam or built-in camera
- **OS:** Windows 10+, macOS 10.14+, Ubuntu 18.04+
- **Python:** 3.9, 3.10, or 3.11

## 🚨 Known Issues

- First launch may be slower (MediaPipe model loading)
- Gesture detection works best with good lighting
- Face tracking requires clear view of face
- Performance varies by hardware

## 📊 Performance Tips

1. **Lighting:** Use bright, even lighting for best tracking
2. **Background:** Plain backgrounds work better
3. **Distance:** Sit 2-3 feet from camera
4. **Gestures:** Make clear, deliberate gestures
5. **CPU:** Close unnecessary applications

## 🔧 Advanced Configuration

### Modify Colors (in `hud.py`)
```python
self.cyan = (255, 255, 0)      # BGR format
self.orange = (0, 165, 255)
self.red = (0, 0, 255)
```

### Adjust Evolution Speed (in `main.py`)
```python
# Faster evolution
self.cyborg_evolution = min(100.0, self.cyborg_evolution + 0.2)  # Was 0.1
```

### Change Gesture Sensitivity (in `gestures.py`)
```python
# Pinch detection threshold
if distance < 0.08:  # Was 0.05 (higher = easier to trigger)
```

## 🎬 Demo

The system creates a cyberpunk-style AR overlay that matches the reference images:

- **Left side:** Animated neural network wireframe
- **Right side:** Evolution progress bars  
- **Center:** Face tracking with crosshairs
- **Hands:** Circuit overlays on gesture detection
- **UI:** Futuristic cyan/orange color scheme

## 🆘 Support

If you encounter issues:

1. Check camera permissions
2. Verify Python version (3.9-3.11)
3. Try different lighting conditions
4. Restart the application
5. Check system requirements

## 🚀 Future Enhancements

- [ ] Voice command integration
- [ ] Custom gesture training
- [ ] Recording/playback features  
- [ ] Multi-person tracking
- [ ] VR headset integration
- [ ] Mobile app version

---

## 📄 **License & Attribution**

This project is **open source** but please respect the creator's work:

- ✅ **Fork it** and give it a ⭐
- ✅ **Share it** with proper attribution to [@imluban](https://github.com/imluban)
- ✅ **Modify it** for your own projects (with credit)
- ✅ **Learn from it** and build something even cooler!

**Please DON'T:**
- ❌ Copy without giving credit to the original creator
- ❌ Claim it as your own work
- ❌ Remove attribution from the code

## 🙏 **Credits & Acknowledgments**

- **Original Concept & Implementation:** [@imluban](https://github.com/imluban)
- **AI Computer Vision:** MediaPipe by Google
- **Graphics Processing:** OpenCV
- **Inspired by:** Cyberpunk 2077, Ghost in the Shell, The Matrix

## 🤝 **Contributing**

Want to make this even more awesome? Contributions are welcome!

1. Fork this repository
2. Create a feature branch
3. Make your epic improvements
4. Submit a pull request
5. Get featured as a contributor!

---

⭐ **Don't forget to star this repo if you found it awesome!** ⭐

Cybernetic-AR-HUD

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README