File size: 2,321 Bytes
7c01fa9
 
 
 
 
 
 
 
 
88dacfe
adcc112
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
88dacfe
 
 
adcc112
 
 
88dacfe
 
 
adcc112
88dacfe
 
 
adcc112
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
---
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
```

---