😊 Face Analysis

Analisis Wajah Secara Real-Time Menggunakan OpenCV, Haar Cascade, dan Hugging Face Transformers

Face Analysis merupakan aplikasi berbasis Python yang digunakan untuk melakukan analisis wajah secara real-time melalui webcam. Project ini mampu mendeteksi wajah, mengenali ekspresi, memprediksi usia, serta mengidentifikasi jenis kelamin menggunakan model deep learning dari Hugging Face Transformers.

Project ini menggabungkan OpenCV untuk deteksi wajah dengan Vision Transformer (ViT) untuk klasifikasi ekspresi, usia, dan gender.

---

✨ Fitur

• 😊 Deteksi wajah secara real-time
• 😀 Klasifikasi ekspresi wajah
• 👤 Prediksi usia
• 🚻 Prediksi jenis kelamin
• 📷 Mendukung webcam
• ⚡ Menggunakan model Hugging Face Transformers
• 🎨 Warna berbeda untuk setiap ekspresi wajah
• 🖥️ Menampilkan hasil prediksi secara langsung pada video

---

🛠️ Tech Stack

• Python
• OpenCV
• Hugging Face Transformers
• PyTorch
• Pillow
• NumPy
• Haar Cascade Classifier

---

📂 Struktur Project

FaceAnalysis/
│
├── expression_detection.py
├── age_gender_detection.py
├── requirements.txt
└── README.md

---

🚀 Instalasi

Clone repository

git clone https://github.com/ade-m/FaceAnalysis.git

cd FaceAnalysis

Install dependency

pip install -r requirements.txt

Atau install secara manual

pip install opencv-python transformers torch pillow numpy

---

🤖 Model yang Digunakan

Fitur	Model
Deteksi Wajah	OpenCV Haar Cascade
Deteksi Ekspresi	trpakov/vit-face-expression
Prediksi Usia	dima806/facial_age_image_detection
Prediksi Gender	rizvandwiki/gender-classification

---

🚀 Menjalankan Aplikasi

😊 Deteksi Ekspresi Wajah

python expression_detection.py

Aplikasi akan:

• Mendeteksi wajah
• Mengklasifikasikan ekspresi
• Memberikan warna berbeda untuk setiap ekspresi
• Menampilkan hasil secara real-time

---

👤 Prediksi Usia dan Jenis Kelamin

python age_gender_detection.py

Aplikasi akan:

• Mendeteksi wajah
• Memperkirakan rentang usia
• Mengidentifikasi jenis kelamin
• Menampilkan hasil pada setiap wajah yang terdeteksi

---

😀 Ekspresi yang Didukung

Model mampu mengenali beberapa ekspresi berikut.

Ekspresi	Keterangan
😀 Happy	Senang
😢 Sad	Sedih
😠 Angry	Marah
😮 Surprise	Terkejut
🤢 Disgust	Jijik
😨 Fear	Takut
😐 Neutral	Netral

---

🔄 Alur Sistem

Webcam
   │
   ▼
Deteksi Wajah
(OpenCV Haar Cascade)
   │
   ▼
Crop Wajah
   │
   ▼
Vision Transformer
(Hugging Face)
   │
   ├──────────────┐
   ▼              ▼
Ekspresi      Usia & Gender
   │              │
   └──────────────┘
          ▼
Visualisasi Hasil

---

📡 Sumber Input

Sumber	Status
Webcam	✅
Kamera USB	✅
Video Lokal*	⚠️ Perlu penyesuaian
RTSP Camera*	⚠️ Perlu penyesuaian

*Saat ini implementasi menggunakan webcam, namun dapat dikembangkan untuk mendukung video lokal maupun kamera IP.

---

🔮 Roadmap

• Face Recognition
• Face Tracking
• Multi Face Analysis
• Deteksi Masker
• Estimasi Emosi Secara Statistik
• Dashboard Monitoring
• REST API
• Docker Support
• GPU Acceleration
• Export Hasil Analisis

---

🤝 Kontribusi

Kontribusi dalam bentuk Issue, Pull Request, maupun usulan fitur baru sangat terbuka untuk membantu pengembangan project ini.

---

👨‍💻 Author

Ade Maulana

• 🌐 GitHub: https://github.com/ade-m
• 📸 Instagram: https://instagram.com/ademaulana_

---

⭐ Support

Apabila project ini bermanfaat, jangan lupa berikan ⭐ Star pada repository GitHub ini agar dapat membantu pengembangan ke depannya.

---

Dibangun dengan ❤️ menggunakan Python, OpenCV, dan Hugging Face Transformers.