# srisaravanan55/-gesture-calc-ai architecture

> Architecture diagram of the GitHub repository srisaravanan55/-gesture-calc-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/srisaravanan55/-gesture-calc-ai
- Repository: https://github.com/srisaravanan55/-gesture-calc-ai

## Overview

GestureCalc is a Flask web app for operating a calculator through webcam hand gestures, with browser-based modes and optional Gemini assistance. The documented workflow is browser interaction with the app, webcam frame processing, hand-landmark and gesture recognition, then gesture-driven calculator input and displayed feedback. The excerpt shows camera capture, classification, shared state, skeleton rendering, and AI queries; it does not show the calculator or browser routes, so those capabilities and links are documented rather than inferred from unsampled code.

Main entry points: [`templates/index.html`](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/templates/index.html) (Browser UI), [`app.py`](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py) (Webcam capture), [`hand_landmarker.task`](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/hand_landmarker.task) (Landmarker model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_browser["Browser UI<br/>[index.html]"]
  node_flask["Flask app<br/>[app.py]"]
end

subgraph group_vision["Gesture recognition"]
  node_camera["Webcam capture<br/>[app.py]"]
  node_landmarks["Hand landmarks<br/>[app.py]"]
  node_finger["Finger states<br/>[app.py]"]
  node_classifier["Gesture classifier<br/>[app.py]"]
  node_debounce["Hold debounce<br/>[app.py]"]
  node_overlay["Skeleton overlay<br/>[app.py]"]
  node_state["Gesture state<br/>[app.py]"]
  node_model["Landmarker model"]
end

subgraph group_calc["Calculator modes"]
  node_standard["Standard calculator<br/>[app.py]"]
  node_scientific["Scientific mode<br/>[app.py]"]
  node_airdraw["Air Draw<br/>[app.py]"]
  node_voice["Voice input<br/>[app.py]"]
end

subgraph group_ai["AI assistance"]
  node_gemini["Gemini AI<br/>[app.py]"]
end

node_user(("User"))
node_camera_service["Camera"]

node_user -->|"uses"| node_browser
node_browser -->|"requests"| node_flask
node_camera -->|"captures frames"| node_camera_service
node_camera -->|"processes frames"| node_landmarks
node_landmarks -.->|"loads"| node_model
node_landmarks -->|"provides landmarks"| node_finger
node_finger -->|"classifies states"| node_classifier
node_classifier -->|"debounces gesture"| node_debounce
node_camera -->|"draws skeleton"| node_overlay
node_debounce -->|"updates"| node_state
node_state -.->|"provides gesture feedback"| node_browser
node_browser -.->|"selects inputs"| node_standard
node_browser -.->|"selects mode"| node_scientific
node_browser -.->|"starts tracing"| node_airdraw
node_browser -.->|"submits speech"| node_voice
node_voice -.->|"parses calculations"| node_gemini
node_browser -->|"requests assistance"| node_gemini
node_gemini -->|"returns response"| node_browser

click node_browser "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/templates/index.html"
click node_flask "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_camera "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_landmarks "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_finger "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_classifier "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_debounce "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_overlay "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_state "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_standard "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_scientific "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_airdraw "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_voice "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_gemini "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py"
click node_model "https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/hand_landmarker.task"

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_browser,node_flask,node_user toneBlue
class node_camera,node_landmarks,node_finger,node_classifier,node_debounce,node_overlay,node_state,node_model toneAmber
class node_standard,node_scientific,node_airdraw,node_voice toneMint
class node_gemini toneRose
class node_camera_service toneIndigo
```

## Components

### Web interface

- [Browser UI](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/templates/index.html): `templates/index.html`
- [Flask app](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`

### Gesture recognition

- [Webcam capture](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Hand landmarks](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Finger states](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Gesture classifier](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Hold debounce](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Skeleton overlay](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Gesture state](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Landmarker model](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/hand_landmarker.task): `hand_landmarker.task`

### Calculator modes

- [Standard calculator](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Scientific mode](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Air Draw](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`
- [Voice input](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`

### AI assistance

- [Gemini AI](https://github.com/srisaravanan55/-gesture-calc-ai/blob/main/app.py): `app.py`

### Other components

- **User**
- **Camera**

## Connections

- User → Browser UI: uses (evidence: `README.md`)
- Browser UI → Flask app: requests (evidence: `README.md`)
- Webcam capture → Camera: captures frames (evidence: `app.py`)
- Webcam capture → Hand landmarks: processes frames (evidence: `app.py`)
- Hand landmarks → Landmarker model: loads
- Hand landmarks → Finger states: provides landmarks (evidence: `app.py`)
- Finger states → Gesture classifier: classifies states (evidence: `app.py`)
- Gesture classifier → Hold debounce: debounces gesture (evidence: `app.py`)
- Webcam capture → Skeleton overlay: draws skeleton (evidence: `app.py`)
- Hold debounce → Gesture state: updates (evidence: `app.py`)
- Gesture state → Browser UI: provides gesture feedback
- Browser UI → Standard calculator: selects inputs (evidence: `README.md`)
- Browser UI → Scientific mode: selects mode (evidence: `README.md`)
- Browser UI → Air Draw: starts tracing (evidence: `README.md`)
- Browser UI → Voice input: submits speech (evidence: `README.md`)
- Voice input → Gemini AI: parses calculations (evidence: `README.md`)
- Browser UI → Gemini AI: requests assistance (evidence: `app.py`)
- Gemini AI → Browser UI: returns response (evidence: `app.py`)
