# soummo19/facialexpressiondetector architecture

> Architecture diagram of the GitHub repository soummo19/facialexpressiondetector, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/soummo19/facialexpressiondetector
- Repository: https://github.com/soummo19/facialexpressiondetector

## Overview

This is a Flask web app that streams webcam frames annotated with one of seven facial-expression labels. A browser loads the page and requests the video feed; the server captures frames, detects faces, prepares each face for the classifier, annotates the frame, and streams it back. The model and Haar-cascade files supply runtime data. The README describes the app’s purpose, while the sampled Python files show the request and inference path; the template contents were not provided, so its behavior is limited to the documented render call.

Main entry points: [`camera.py`](https://github.com/soummo19/facialexpressiondetector/blob/master/camera.py) (Video camera), [`main.py`](https://github.com/soummo19/facialexpressiondetector/blob/master/main.py) (Flask routes), [`model.py`](https://github.com/soummo19/facialexpressiondetector/blob/master/model.py) (Expression model), [`templates/index.html`](https://github.com/soummo19/facialexpressiondetector/blob/master/templates/index.html) (Web page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web streaming"]
  node_flask["Flask routes<br/>[main.py]"]
  node_page["Web page<br/>[index.html]"]
  node_stream["Frame generator<br/>[main.py]"]
end

subgraph group_vision["Vision pipeline"]
  node_camera["Video camera<br/>[camera.py]"]
  node_face_detection["Face detection<br/>[camera.py]"]
  node_cascade["Haar cascade"]
  node_frame_processing["Frame processing<br/>[camera.py]"]
end

subgraph group_classifier["Expression classifier"]
  node_expression_model["Expression model<br/>[model.py]"]
  node_model_json["Model definition<br/>[model.json]"]
  node_model_weights["Model weights<br/>[model_weights.h5]"]
end

node_browser(("Browser"))
node_webcam(("Webcam"))

node_browser -.->|"requests page/feed"| node_flask
node_flask -->|"renders"| node_page
node_flask -->|"streams frames"| node_stream
node_flask -->|"creates"| node_camera
node_stream -->|"requests frames"| node_camera
node_camera -->|"captures frames"| node_webcam
node_camera -->|"detects faces"| node_face_detection
node_face_detection -->|"uses classifier"| node_cascade
node_camera -->|"prepares and encodes"| node_frame_processing
node_camera -->|"predicts emotion"| node_expression_model
node_expression_model -->|"loads definition"| node_model_json
node_expression_model -->|"loads weights"| node_model_weights
node_frame_processing -->|"returns JPEG stream"| node_browser

click node_flask "https://github.com/soummo19/facialexpressiondetector/blob/master/main.py"
click node_page "https://github.com/soummo19/facialexpressiondetector/blob/master/templates/index.html"
click node_stream "https://github.com/soummo19/facialexpressiondetector/blob/master/main.py"
click node_camera "https://github.com/soummo19/facialexpressiondetector/blob/master/camera.py"
click node_face_detection "https://github.com/soummo19/facialexpressiondetector/blob/master/camera.py"
click node_cascade "https://github.com/soummo19/facialexpressiondetector/blob/master/haarcascade_frontalface_default.xml"
click node_frame_processing "https://github.com/soummo19/facialexpressiondetector/blob/master/camera.py"
click node_expression_model "https://github.com/soummo19/facialexpressiondetector/blob/master/model.py"
click node_model_json "https://github.com/soummo19/facialexpressiondetector/blob/master/model.json"
click node_model_weights "https://github.com/soummo19/facialexpressiondetector/blob/master/model_weights.h5"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_flask,node_page,node_stream,node_browser toneBlue
class node_camera,node_face_detection,node_cascade,node_frame_processing toneAmber
class node_expression_model,node_model_json,node_model_weights toneMint
class node_webcam toneIndigo
```

## Components

### Web streaming

- [Flask routes](https://github.com/soummo19/facialexpressiondetector/blob/master/main.py): `main.py`
- [Web page](https://github.com/soummo19/facialexpressiondetector/blob/master/templates/index.html): `templates/index.html`
- [Frame generator](https://github.com/soummo19/facialexpressiondetector/blob/master/main.py): `main.py`

### Vision pipeline

- [Video camera](https://github.com/soummo19/facialexpressiondetector/blob/master/camera.py): `camera.py`
- [Face detection](https://github.com/soummo19/facialexpressiondetector/blob/master/camera.py): `camera.py`
- [Haar cascade](https://github.com/soummo19/facialexpressiondetector/blob/master/haarcascade_frontalface_default.xml): `haarcascade_frontalface_default.xml`
- [Frame processing](https://github.com/soummo19/facialexpressiondetector/blob/master/camera.py): `camera.py`

### Expression classifier

- [Expression model](https://github.com/soummo19/facialexpressiondetector/blob/master/model.py): `model.py`
- [Model definition](https://github.com/soummo19/facialexpressiondetector/blob/master/model.json): `model.json`
- [Model weights](https://github.com/soummo19/facialexpressiondetector/blob/master/model_weights.h5): `model_weights.h5`

### Other components

- **Browser**
- **Webcam**

## Connections

- Browser → Flask routes: requests page/feed (evidence: `README.md`)
- Flask routes → Web page: renders (evidence: `main.py`)
- Flask routes → Frame generator: streams frames (evidence: `main.py`)
- Flask routes → Video camera: creates (evidence: `main.py`)
- Frame generator → Video camera: requests frames (evidence: `main.py`)
- Video camera → Webcam: captures frames (evidence: `camera.py`)
- Video camera → Face detection: detects faces (evidence: `camera.py`)
- Face detection → Haar cascade: uses classifier (evidence: `camera.py`)
- Video camera → Frame processing: prepares and encodes (evidence: `camera.py`)
- Video camera → Expression model: predicts emotion (evidence: `camera.py`)
- Expression model → Model definition: loads definition (evidence: `model.py`)
- Expression model → Model weights: loads weights (evidence: `model.py`)
- Frame processing → Browser: returns JPEG stream
