# ad25600/bharatnatyam-coach architecture

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

- Interactive diagram: https://gitdiagram.com/ad25600/bharatnatyam-coach
- Repository: https://github.com/ad25600/bharatnatyam-coach

## Overview

Natya Drishti is a browser-based Bharatanatyam pose coach backed by FastAPI, MediaPipe, and a Random Forest classifier. A user uploads an image or captures a webcam frame; the UI submits it to `/predict`, and the backend detects landmarks, classifies the pose, measures joint deviations, and returns feedback plus a highlighted image for the UI to display. The graph preserves the input, inference, and result stages, along with model/configuration responsibilities. Connections reflect shown calls or README-documented HTTP behavior; training and model-stat generation are outside the runtime workflow.

Main entry points: [`frontend/src/App.jsx`](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/App.jsx) (App state), [`bharatnatyam_backend/app/predictor.py`](https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/predictor.py) (Pose assessment), [`frontend/src/components/InputStage.jsx`](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/InputStage.jsx) (Image input), [`frontend/src/components/WebcamCapture.jsx`](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/WebcamCapture.jsx) (Webcam capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_app["App state<br/>[App.jsx]"]
  node_header["Header<br/>[Header.jsx]"]
  node_input["Image input<br/>[InputStage.jsx]"]
  node_webcam["Webcam capture<br/>[WebcamCapture.jsx]"]
  node_results["Result display<br/>[ResultStage.jsx]"]
  node_gauge["Accuracy gauge<br/>[ArchGauge.jsx]"]
end

subgraph group_transport["API transport"]
  node_api_client["API client<br/>[api.js]"]
  node_predict_route["Predict endpoint<br/>[main.py]"]
end

subgraph group_inference["Pose inference"]
  node_predictor["Pose assessment<br/>[predictor.py]"]
  node_detector["Landmark detection<br/>[pose_detector.py]"]
  node_models["Model and statistics<br/>[model_loader.py]"]
  node_visualization["Pose highlighting<br/>[visualization.py]"]
end

subgraph group_runtime["Runtime configuration"]
  node_config["Inference settings<br/>[config.py]"]
  node_landmarker_asset["Landmarker task"]
end

node_user(("Dancer"))
node_camera(("Browser camera"))

node_user -->|"provides image"| node_input
node_input -->|"offers capture"| node_webcam
node_webcam -->|"captures from"| node_camera
node_webcam -->|"returns frame"| node_input
node_app -->|"renders"| node_header
node_app -->|"renders"| node_input
node_app -->|"passes result"| node_results
node_app -->|"requests analysis"| node_api_client
node_results -->|"renders accuracy"| node_gauge
node_api_client -->|"posts image"| node_predict_route
node_predict_route -->|"calls"| node_predictor
node_predictor -->|"detects landmarks"| node_detector
node_predictor -->|"predicts and reads ranges"| node_models
node_predictor -->|"highlights deviations"| node_visualization
node_detector -->|"reads settings"| node_config
node_models -->|"reads artifact paths"| node_config
node_detector -.->|"loads model"| node_landmarker_asset

click node_app "https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/App.jsx"
click node_header "https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/Header.jsx"
click node_input "https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/InputStage.jsx"
click node_webcam "https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/WebcamCapture.jsx"
click node_results "https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/ResultStage.jsx"
click node_gauge "https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/ArchGauge.jsx"
click node_api_client "https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/api.js"
click node_predict_route "https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/main.py"
click node_predictor "https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/predictor.py"
click node_detector "https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/pose_detector.py"
click node_models "https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/model_loader.py"
click node_visualization "https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/visualization.py"
click node_config "https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/config.py"
click node_landmarker_asset "https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/models/pose_landmarker_full.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_app,node_header,node_input,node_webcam,node_results,node_gauge,node_camera toneBlue
class node_api_client,node_predict_route toneAmber
class node_predictor,node_detector,node_models,node_visualization toneMint
class node_config,node_landmarker_asset toneRose
class node_user toneIndigo
```

## Components

### User experience

- [App state](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Header](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/Header.jsx): `frontend/src/components/Header.jsx`
- [Image input](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/InputStage.jsx): `frontend/src/components/InputStage.jsx`
- [Webcam capture](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/WebcamCapture.jsx): `frontend/src/components/WebcamCapture.jsx`
- [Result display](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/ResultStage.jsx): `frontend/src/components/ResultStage.jsx`
- [Accuracy gauge](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/components/ArchGauge.jsx): `frontend/src/components/ArchGauge.jsx`

### API transport

- [API client](https://github.com/ad25600/bharatnatyam-coach/blob/main/frontend/src/api.js): `frontend/src/api.js`
- [Predict endpoint](https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/main.py): `bharatnatyam_backend/main.py`

### Pose inference

- [Pose assessment](https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/predictor.py): `bharatnatyam_backend/app/predictor.py`
- [Landmark detection](https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/pose_detector.py): `bharatnatyam_backend/app/pose_detector.py`
- [Model and statistics](https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/model_loader.py): `bharatnatyam_backend/app/model_loader.py`
- [Pose highlighting](https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/visualization.py): `bharatnatyam_backend/app/visualization.py`

### Runtime configuration

- [Inference settings](https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/app/config.py): `bharatnatyam_backend/app/config.py`
- [Landmarker task](https://github.com/ad25600/bharatnatyam-coach/blob/main/bharatnatyam_backend/models/pose_landmarker_full.task): `bharatnatyam_backend/models/pose_landmarker_full.task`

### Other components

- **Dancer**
- **Browser camera**

## Connections

- Dancer → Image input: provides image (evidence: `frontend/src/components/InputStage.jsx`)
- Image input → Webcam capture: offers capture (evidence: `frontend/src/components/InputStage.jsx`)
- Webcam capture → Browser camera: captures from (evidence: `frontend/src/components/WebcamCapture.jsx`)
- Webcam capture → Image input: returns frame (evidence: `frontend/src/components/InputStage.jsx`)
- App state → Header: renders (evidence: `frontend/src/App.jsx`)
- App state → Image input: renders (evidence: `frontend/src/App.jsx`)
- App state → Result display: passes result (evidence: `frontend/src/App.jsx`)
- App state → API client: requests analysis (evidence: `frontend/src/App.jsx`)
- Result display → Accuracy gauge: renders accuracy (evidence: `frontend/src/components/ResultStage.jsx`)
- API client → Predict endpoint: posts image (evidence: `frontend/src/api.js`)
- Predict endpoint → Pose assessment: calls (evidence: `bharatnatyam_backend/main.py`)
- Pose assessment → Landmark detection: detects landmarks (evidence: `bharatnatyam_backend/app/predictor.py`)
- Pose assessment → Model and statistics: predicts and reads ranges (evidence: `bharatnatyam_backend/app/predictor.py`)
- Pose assessment → Pose highlighting: highlights deviations (evidence: `bharatnatyam_backend/app/predictor.py`)
- Landmark detection → Inference settings: reads settings (evidence: `bharatnatyam_backend/app/pose_detector.py`)
- Model and statistics → Inference settings: reads artifact paths (evidence: `bharatnatyam_backend/app/model_loader.py`)
- Landmark detection → Landmarker task: loads model
