# bahrombekk/face_recognition_backup_full architecture

> Architecture diagram of the GitHub repository bahrombekk/face_recognition_backup_full, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bahrombekk/face_recognition_backup_full
- Repository: https://github.com/bahrombekk/face_recognition_backup_full

## Overview

##### Project type and purpose
- This is a specialized face-recognition pipeline/CLI application in Python.
- It collects faces via camera, aligns/encodes them into 512-dim vectors using InsightFace, stores them in LMDB, and performs real-time recognition or single-image matching.

##### File structure
- Top level:
- faceid/ directory – contains all submodules (data, database, code, README).
- main.py – launcher stub (delegates to faceid/main.py).
- faceid/data/ – raw, aligned, and temp images.
- faceid/baza/ – LMDB database, backups, logs.
- faceid/cod/ – collector, config, encoder, recognition, tests, comparison script, main script.

##### README insights
- Core components: data collection, encoding, storage, recognition, comparison.
- Tech stack: Python3.8+, OpenCV, NumPy, InsightFace, TensorFlow, LMDB, scikit-learn.
- Supports CPU/GPU automatically.
- Configurable via cod/config/config.py.
- Logging under baza/logs/, tests under cod/tests/.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "faceid/ (Package Root)"
        click PackageRoot "https://github.com/bahrombekk/face_recognition_backup_full/tree/main/faceid/"
        subgraph "CLI Layer"
            UI["User Interface\nmain.py"]:::processing
            click UI "https://github.com/bahrombekk/face_recognition_backup_full/blob/main/main.py"
            Docs["Project Documentation\nREADME.md"]:::support
            click Docs "https://github.com/bahrombekk/face_recognition_backup_full/blob/main/README.md"
        end
        subgraph "Configuration"
            Config["Configuration\ncod/config"]:::support
        end
        subgraph "Data Collection & Preprocessing"
            Collector["Camera Input & Data Collector\ncod/collector"]:::processing
            Preprocess["Preprocessing & Alignment\n(OpenCV)"]:::processing
        end
        subgraph "Encoding"
            Encoder["Encoder Engine\ncod/encoder"]:::processing
            Model["InsightFace Model\n(Autodetect CPU/GPU)"]:::support
        end
        subgraph "Storage"
            FS["Filesystem Storage\nfaceid/data"]:::storage
            DB["LMDB Database\nbaza/face_encodings_db"]:::storage
            Backups["Database Backups\nbaza/backups"]:::storage
            Logs["Logging & Monitoring\nbaza/logs"]:::support
        end
        subgraph "Recognition & Comparison"
            Recognition["Recognition Engine\ncod/recognition"]:::processing
            Comparison["Comparison Module\ncompare_image_with_database.py"]:::processing
        end
        Tests["Unit Tests\ncod/tests"]:::support
    end

    UI -->|"load settings"| Config
    UI -->|"start collection"| Collector
    Collector -->|"raw images"| FS
    Collector -->|"aligned images"| Preprocess
    Preprocess -->|"aligned images"| Encoder
    Encoder -->|"store embeddings"| DB
    Encoder -->|"store aligned data"| FS
    Recognition -->|"camera feed"| Encoder
    Recognition -->|"query embeddings"| DB
    Recognition -->|"results"| UI
    Comparison -->|"input image"| Encoder
    Comparison -->|"query embeddings"| DB
    Comparison -->|"output results"| UI

    Collector -->|"log events"| Logs
    Preprocess -->|"log events"| Logs
    Encoder -->|"log events"| Logs
    Recognition -->|"log events"| Logs
    Comparison -->|"log events"| Logs
    UI -->|"log events"| Logs
    Config -->|"log events"| Logs

    Tests -->|"test collector"| Collector
    Tests -->|"test encoder"| Encoder
    Tests -->|"test recognition"| Recognition

    classDef processing fill:#c7e9c0,stroke:#2a6f2c,color:#000
    classDef storage fill:#fdd0a2,stroke:#e6550d,color:#000
    classDef support fill:#d9d9d9,stroke:#636363,color:#000
    classDef dataflow stroke-dasharray: 5 5,stroke:#3182bd,color:#3182bd
```
