# nourchene-hamrita/ai-virtualpainter architecture

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

- Interactive diagram: https://gitdiagram.com/nourchene-hamrita/ai-virtualpainter
- Repository: https://github.com/nourchene-hamrita/ai-virtualpainter

## Overview

This appears to be a small hand-tracked virtual-painting application, with `VirtualPainter.py` as the product layer and `HandTrackingModule.py` as its tracking dependency. The tree also contains `main.py`, but its indexed references do not show how it connects to the painter. The README is empty and the application sources were not excerpted, so the startup flow and painting behavior cannot be described confidently; the only supported internal link is the painter’s reference to the tracking module.

Main entry points: [`main.py`](https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/main.py) (Application entry), [`VirtualPainter.py`](https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/VirtualPainter.py) (Virtual painter), [`HandTrackingModule.py`](https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/HandTrackingModule.py) (Hand tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Painting app"]
  node_launcher["Application entry<br/>[main.py]"]
  node_painter["Virtual painter<br/>[VirtualPainter.py]"]
end

subgraph group_tracking["Hand tracking"]
  node_tracker["Hand tracking"]
end

node_user(("User"))

node_user -.->|"starts"| node_launcher
node_launcher -.->|"launches"| node_painter
node_painter -->|"imports"| node_tracker

click node_launcher "https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/main.py"
click node_painter "https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/VirtualPainter.py"
click node_tracker "https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/HandTrackingModule.py"

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_launcher,node_painter,node_user toneBlue
class node_tracker toneAmber
```

## Components

### Painting app

- [Application entry](https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/main.py): `main.py`
- [Virtual painter](https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/VirtualPainter.py): `VirtualPainter.py`

### Hand tracking

- [Hand tracking](https://github.com/nourchene-hamrita/ai-virtualpainter/blob/main/HandTrackingModule.py): `HandTrackingModule.py`

### Other components

- **User**

## Connections

- User → Application entry: starts
- Application entry → Virtual painter: launches
- Virtual painter → Hand tracking: imports (evidence: `VirtualPainter.py`)
