# himel-tasrif/ai-photo-finder architecture

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

- Interactive diagram: https://gitdiagram.com/himel-tasrif/ai-photo-finder
- Repository: https://github.com/himel-tasrif/ai-photo-finder

## Overview

AI Photo Finder is documented as a web app for event-photo discovery. Photographers upload an event gallery; attendees submit a personal photo; face recognition searches the gallery through FAISS, and attendees view and download matches. The repository tree provides no application source, so components are documented capabilities rather than verified implementation modules; all shown relationships come from the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_users["Users"]
end

subgraph group_app["Web app"]
  node_frontend["React frontend"]
  node_api["Flask API"]
  node_matches["Matched photos"]
end

subgraph group_matching["Photo matching"]
  node_gallery[("Event gallery")]
  node_faceai["Face recognition"]
  node_faiss["FAISS search"]
end

node_photographer(("Photographer"))
node_attendee(("Attendee"))

node_photographer -->|"uploads gallery"| node_frontend
node_attendee -->|"submits photo"| node_frontend
node_frontend -.->|"sends requests"| node_api
node_api -.->|"stores gallery"| node_gallery
node_api -->|"processes photo"| node_faceai
node_faceai -->|"searches gallery"| node_faiss
node_faiss -->|"finds photos"| node_matches
node_matches -->|"displays results"| node_frontend
node_frontend -->|"offers downloads"| node_attendee

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_frontend,node_api,node_matches toneAmber
class node_gallery,node_faceai,node_faiss toneMint
class node_photographer,node_attendee toneIndigo
```

## Components

### Web app

- **React frontend**
- **Flask API**
- **Matched photos**

### Photo matching

- **Event gallery**
- **Face recognition**
- **FAISS search**

### Other components

- **Photographer**
- **Attendee**

## Connections

- Photographer → React frontend: uploads gallery (evidence: `README.md`)
- Attendee → React frontend: submits photo (evidence: `README.md`)
- React frontend → Flask API: sends requests
- Flask API → Event gallery: stores gallery
- Flask API → Face recognition: processes photo (evidence: `README.md`)
- Face recognition → FAISS search: searches gallery (evidence: `README.md`)
- FAISS search → Matched photos: finds photos (evidence: `README.md`)
- Matched photos → React frontend: displays results (evidence: `README.md`)
- React frontend → Attendee: offers downloads (evidence: `README.md`)
