🤖 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
• 🏗️ Project Structure
• 🚀 Quick Start
• 🎨 Features
• 🛠️ Tech Stack
• 📋 Roadmap
• 🎪 Demo Use Cases
• 🤝 Contributing
• 📄 License
• 🆘 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

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

# Clone repo
git clone <repository-url>
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

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/ for guidelines.

---

📄 License

Licensed under the MIT License – see LICENSE.

---

🆘 Support

• 📖 Docs → docs/
• 🐞 Issues → GitHub Issues
• 💬 Contact → IRIS Robotics Club

Built with ❤️ by the IRIS Robotics Club 🤖✨