# ravichandranayakar/ai_photographer architecture

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

- Interactive diagram: https://gitdiagram.com/ravichandranayakar/ai_photographer
- Repository: https://github.com/ravichandranayakar/ai_photographer

## Overview

Frozen AI is a Flutter pose-coaching camera app. The intended workflow is to choose a target pose, analyze live camera landmarks, stabilize and normalize them, compare the subject’s pose, then render a target silhouette and coaching cues; a sustained match is intended to trigger capture. README documents these capabilities, but the provided source excerpts do not include Dart runtime code, so implementation-level links are limited to those documented relationships. The pose-authoring tool and research components are included as distinct product capabilities; planned paywall and capture features are not represented as confirmed implementations.

Main entry points: [`lib/engine/matcher/euclidean_matcher.dart`](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/matcher/euclidean_matcher.dart) (Pose Matcher), [`lib/main.dart`](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main.dart) (Flutter Camera UI), [`lib/engine/research/target_poses.dart`](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/research/target_poses.dart) (Target Pose Library), [`lib/engine/state/pose_session_state_machine.dart`](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/state/pose_session_state_machine.dart) (Pose Session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Camera App"]
  node_appui["Flutter Camera UI<br/>[main.dart]"]
  node_pose_library["Target Pose Library<br/>[target_poses.dart]"]
  node_session["Pose Session"]
  node_app_state["Session Controller"]
  node_capture["Photo Capture<br/>[main.dart]"]
  node_gallery[("Gallery Storage<br/>[main.dart]")]
end

subgraph group_vision["Pose Analysis"]
  node_smoothing["Landmark Smoothing"]
  node_normalizer["Landmark Normalizer"]
end

subgraph group_engine["Intelligence Engine"]
  node_matcher["Pose Matcher"]
  node_guidance["Coaching Decisions"]
  node_guidance_view["Guidance Rendering"]
  node_silhouette["Capsule CSG Silhouette<br/>[csg_extractor.dart]"]
  node_silhouette_view["Silhouette Rendering"]
end

subgraph group_authoring["Authoring and Research"]
  node_authoring_tool["Pose Authoring Tool"]
  node_pose_validation["Pose Validation"]
  node_pose_serialization["Pose Serialization"]
  node_research["Algorithm Research"]
end

node_user(("Photographer"))
node_camera["Camera Feed"]
node_mlkit["ML Kit Vision"]

node_user -->|"selects pose"| node_appui
node_camera -->|"provides frames"| node_mlkit
node_mlkit -->|"extracts landmarks"| node_smoothing
node_smoothing -->|"stabilizes landmarks"| node_normalizer
node_normalizer -->|"normalizes skeleton"| node_matcher
node_pose_library -.->|"supplies target"| node_matcher
node_matcher -->|"scores alignment"| node_guidance
node_guidance -->|"drives cues"| node_guidance_view
node_pose_library -->|"defines target"| node_silhouette
node_silhouette -->|"produces outline"| node_silhouette_view
node_silhouette_view -->|"renders over viewfinder"| node_appui
node_guidance_view -->|"renders coaching"| node_appui
node_matcher -->|"updates match state"| node_session
node_session -.->|"triggers on sustained match"| node_capture
node_capture -.->|"saves photograph"| node_gallery
node_user -->|"authors poses"| node_authoring_tool
node_authoring_tool -.->|"validates poses"| node_pose_validation
node_pose_validation -.->|"serializes accepted poses"| node_pose_serialization
node_user -.->|"evaluates algorithms"| node_research

click node_appui "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main.dart"
click node_pose_library "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/research/target_poses.dart"
click node_session "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/state/pose_session_state_machine.dart"
click node_app_state "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/state/session_controller.dart"
click node_smoothing "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/smoothing/frozen_euro_filter.dart"
click node_normalizer "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/normalizer/landmark_normalizer.dart"
click node_matcher "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/matcher/euclidean_matcher.dart"
click node_guidance "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/guidance/decision_engine.dart"
click node_guidance_view "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/guidance/guidance_arrow_painter.dart"
click node_silhouette "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/silhouette_b/contour/v2_csg/csg_extractor.dart"
click node_silhouette_view "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/silhouette/silhouette_painter.dart"
click node_capture "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main.dart"
click node_gallery "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main.dart"
click node_authoring_tool "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main_authoring.dart"
click node_pose_validation "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/authoring/pose_quality_gate.dart"
click node_pose_serialization "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/authoring/pose_serializer.dart"
click node_research "https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/research/evaluate_topic_4.dart"

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_appui,node_pose_library,node_session,node_app_state,node_capture,node_gallery toneBlue
class node_smoothing,node_normalizer toneAmber
class node_matcher,node_guidance,node_guidance_view,node_silhouette,node_silhouette_view toneMint
class node_authoring_tool,node_pose_validation,node_pose_serialization,node_research toneRose
class node_user,node_camera,node_mlkit toneIndigo
```

## Components

### Camera App

- [Flutter Camera UI](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main.dart): `lib/main.dart`
- [Target Pose Library](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/research/target_poses.dart): `lib/engine/research/target_poses.dart`
- [Pose Session](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/state/pose_session_state_machine.dart): `lib/engine/state/pose_session_state_machine.dart`
- [Session Controller](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/state/session_controller.dart): `lib/engine/state/session_controller.dart`
- [Photo Capture](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main.dart): `lib/main.dart`
- [Gallery Storage](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main.dart): `lib/main.dart`

### Pose Analysis

- [Landmark Smoothing](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/smoothing/frozen_euro_filter.dart): `lib/engine/smoothing/frozen_euro_filter.dart`
- [Landmark Normalizer](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/normalizer/landmark_normalizer.dart): `lib/engine/normalizer/landmark_normalizer.dart`

### Intelligence Engine

- [Pose Matcher](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/matcher/euclidean_matcher.dart): `lib/engine/matcher/euclidean_matcher.dart`
- [Coaching Decisions](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/guidance/decision_engine.dart): `lib/engine/guidance/decision_engine.dart`
- [Guidance Rendering](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/guidance/guidance_arrow_painter.dart): `lib/engine/guidance/guidance_arrow_painter.dart`
- [Capsule CSG Silhouette](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/silhouette_b/contour/v2_csg/csg_extractor.dart): `lib/engine/silhouette_b/contour/v2_csg/csg_extractor.dart`
- [Silhouette Rendering](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/silhouette/silhouette_painter.dart): `lib/engine/silhouette/silhouette_painter.dart`

### Authoring and Research

- [Pose Authoring Tool](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/main_authoring.dart): `lib/main_authoring.dart`
- [Pose Validation](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/authoring/pose_quality_gate.dart): `lib/engine/authoring/pose_quality_gate.dart`
- [Pose Serialization](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/authoring/pose_serializer.dart): `lib/engine/authoring/pose_serializer.dart`
- [Algorithm Research](https://github.com/ravichandranayakar/ai_photographer/blob/main/lib/engine/research/evaluate_topic_4.dart): `lib/engine/research/evaluate_topic_4.dart`

### Other components

- **Photographer**
- **Camera Feed**
- **ML Kit Vision**

## Connections

- Photographer → Flutter Camera UI: selects pose (evidence: `README.md`)
- Camera Feed → ML Kit Vision: provides frames (evidence: `README.md`)
- ML Kit Vision → Landmark Smoothing: extracts landmarks (evidence: `README.md`)
- Landmark Smoothing → Landmark Normalizer: stabilizes landmarks (evidence: `README.md`)
- Landmark Normalizer → Pose Matcher: normalizes skeleton (evidence: `README.md`)
- Target Pose Library → Pose Matcher: supplies target (evidence: `README.md`)
- Pose Matcher → Coaching Decisions: scores alignment (evidence: `README.md`)
- Coaching Decisions → Guidance Rendering: drives cues (evidence: `README.md`)
- Target Pose Library → Capsule CSG Silhouette: defines target (evidence: `README.md`)
- Capsule CSG Silhouette → Silhouette Rendering: produces outline (evidence: `README.md`)
- Silhouette Rendering → Flutter Camera UI: renders over viewfinder (evidence: `README.md`)
- Guidance Rendering → Flutter Camera UI: renders coaching (evidence: `README.md`)
- Pose Matcher → Pose Session: updates match state (evidence: `README.md`)
- Pose Session → Photo Capture: triggers on sustained match (evidence: `README.md`)
- Photo Capture → Gallery Storage: saves photograph (evidence: `README.md`)
- Photographer → Pose Authoring Tool: authors poses (evidence: `README.md`)
- Pose Authoring Tool → Pose Validation: validates poses
- Pose Validation → Pose Serialization: serializes accepted poses
- Photographer → Algorithm Research: evaluates algorithms
