README.md

---
title: FocusFlow
emoji: 🎯
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
---

# FocusFlow: Real-Time Meeting Engagement Analytics

> **Premium Engagement Tracking Powered by AI and C++**  
> Focused on Professional Productivity and Group Dynamic Monitoring.

---

## 📋 Project Overview

**FocusFlow** is a modern web application that analyzes video feeds (camera or screen share) to compute real-time **Engagement Scores**. It provides deep insights into focus levels, emotional state, and group dynamics during professional meetings.

### Key Features:
- **Computer Vision**: Face detection, head pose estimation, and iris tracking via MediaPipe.
- **C++ Performance**: High-speed metrics calculation via custom C++ PyBind11 extension.
- **Meeting Intel**: Multi-participant detection and group engagement analytics.
- **Modern UI**: Asymmetric, professional dashboard design with real-time WebSocket feedback.
- **Persistence**: SQLite-backed session history and trend analysis.

---

## 🏗️ Architecture

```mermaid
graph TD
    A[Frontend: Vanilla JS] -->|Frames| B[FastAPI WebSocket]
    B -->|Base64| C[Vision Engine]
    C -->|Points| D[C++ Module]
    D -->|Score| C
    C -->|Metrics| B
    B -->|JSON| A
```

---

## 🛠️ Tech Stack

| Component | Technology |
|-----------|-----------|
| **Backend** | Python 3.10+, FastAPI |
| **Frontend** | HTML5, CSS3, Vanilla JavaScript |
| **Vision** | OpenCV, Google MediaPipe |
| **Performance** | C++17, PyBind11 |
| **Database** | SQLite3 |

---

## 📁 Clean Folder Structure

```
FocusFlow/
├── cpp_modules/       # C++ Performance Module (Source)
├── frontend/          # Modern Web Interface (HTML/CSS/JS)
├── src/               # Core Application Logic
│   ├── main.py        # FastAPI Gateway & Websockets
│   ├── vision_engine.py# AI Vision Orchestrator
│   ├── database.py    # SQLite Persistence Layer
│   └── utils/         # Utility Scripts
├── data/              # Storage (Database files)
├── architecture.md    # Detailed Technical Docs
├── file_manifest.md   # 📄 Breakdown of every file
├── run.bat            # One-Click Launcher (Windows)
├── build_cpp.bat      # C++ Compilation Tool
└── requirements.txt   # Dependencies
```

---