An open API service indexing awesome lists of open source software.

https://github.com/greenhacker420/opencv_exp_age

A real-time facial analysis platform built with Flask, OpenCV, TensorFlow, PyTorch, and Next.js, featuring live face detection, age & gender estimation, and emotion recognition. Designed for robotics club events, tech fairs, and interactive AI demos, with a futuristic cyberpunk UI powered by Arwes.
https://github.com/greenhacker420/opencv_exp_age

age-estimation computer-vision emotion-recognition face-detection facial-analysis gender-detection mediapipe opencv real-time-ai robotics-club tensorflow

Last synced: 2 months ago
JSON representation

A real-time facial analysis platform built with Flask, OpenCV, TensorFlow, PyTorch, and Next.js, featuring live face detection, age & gender estimation, and emotion recognition. Designed for robotics club events, tech fairs, and interactive AI demos, with a futuristic cyberpunk UI powered by Arwes.

Awesome Lists containing this project

README

          

🤖 IRIS Robotics Club – Facial Analysis Platform



A real-time facial analysis platform showcasing Computer Vision + AI for robotics club events and tech fairs.

---

## 📖 Table of Contents
- [✨ Overview](#-overview)
- [🏗️ Project Structure](#️-project-structure)
- [🚀 Quick Start](#-quick-start)
- [🎨 Features](#-features)
- [🛠️ Tech Stack](#️-tech-stack)
- [📋 Roadmap](#-roadmap)
- [🎪 Demo Use Cases](#-demo-use-cases)
- [🤝 Contributing](#-contributing)
- [📄 License](#-license)
- [🆘 Support](#-support)

---

## ✨ Overview
A **real-time facial analysis web platform** designed for robotics club events & tech fairs.
Showcases **live AI-powered facial analysis** with age estimation, gender detection, and emotion recognition in an interactive, futuristic UI.

---

## 🏗️ Project Structure
```bash
openCV_exp_age/
├── prd/ # Product Requirements
├── docs/ # Technical documentation
├── backend/ # Flask + OpenCV
├── frontend/ # Next.js + Arwes
└── docker-compose.yml
```

---

## 🚀 Quick Start
### Prerequisites
- Python **3.12+**
- Node.js **20+**
- Docker (optional)
- Webcam

### Local Setup
```bash
# Clone repo
git clone
cd openCV_exp_age

# Backend
cd backend
pip install -r requirements.txt
python app.py

# Frontend
cd frontend
npm install
npm run dev
```

🌐 Access:
- Frontend → `http://localhost:3000`
- Backend API → `http://localhost:5000`

### Docker Setup
```bash
docker-compose up --build
```

---

## 🎨 Features
- Cyberpunk UI with **Arwes**
- Animated **IRIS loading screen**
- Real-time glowing overlays
- Responsive design
- Multi-face detection (up to 5 people)
- Instant visual/audio feedback
- **Privacy-first** (no storage)
- WCAG 2.1 AA accessibility

---

## 🛠️ Tech Stack



---

## 📋 Roadmap
- ✅ Phase 1 – Setup (Flask + Next.js + WebSocket)
- 🔄 Phase 2 – Core Features (face, age, emotion detection)
- 🔄 Phase 3 – Multi-face support + UI animations
- 🔄 Phase 4 – Production-ready (testing, monitoring, docs)

---

## 🎪 Demo Use Cases
- Robotics club events ⚡
- Tech fairs & exhibitions 🏆
- STEM education 📚
- Museum interactive displays 🏛️

---

## 🤝 Contributing
We welcome contributions!

1. Fork the repo
2. Create a feature branch (`git checkout -b feature-name`)
3. Commit your changes (`git commit -m "Add feature"`)
4. Push and open a PR 🎉

📑 Check [docs/](./docs/) for guidelines.

---

## 📄 License
Licensed under the **MIT License** – see [LICENSE](./LICENSE).

---

## 🆘 Support
- 📖 Docs → [docs/](./docs/)
- 🐞 Issues → [GitHub Issues](../../issues)
- 💬 Contact → IRIS Robotics Club

Built with ❤️ by the IRIS Robotics Club 🤖✨