# chevesqueaky/carai architecture

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

- Interactive diagram: https://gitdiagram.com/chevesqueaky/carai
- Repository: https://github.com/chevesqueaky/carai

## Overview

The repository appears to be a small Python web application with car-related AI code, but the README is empty and the sampled files do not show how the AI module is used. The visible entry path is `run.py` into the `WebApp` package and then its routes. The connection from routes to car AI is therefore shown as unverified; no specific user-to-result behavior can be established from the available evidence. The large virtual-environment package tree is vendored tooling, not the application workflow.

Main entry points: [`run.py`](https://github.com/chevesqueaky/carai/blob/main/run.py) (App runner), [`WebApp/__init__.py`](https://github.com/chevesqueaky/carai/blob/main/WebApp/__init__.py) (Web app), [`WebApp/route.py`](https://github.com/chevesqueaky/carai/blob/main/WebApp/route.py) (Route handlers), [`pythonApp/IA_car.py`](https://github.com/chevesqueaky/carai/blob/main/pythonApp/IA_car.py) (Car AI logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_runner["App runner<br/>[run.py]"]
  node_app["Web app<br/>[__init__.py]"]
  node_routes["Route handlers<br/>[route.py]"]
end

subgraph group_ai["Car AI"]
  node_car_ai["Car AI logic<br/>[IA_car.py]"]
end

node_user(("User"))

node_runner -->|"starts"| node_app
node_app -->|"imports"| node_routes
node_routes -.->|"may invoke"| node_car_ai
node_user -.->|"initiates"| node_runner

click node_runner "https://github.com/chevesqueaky/carai/blob/main/run.py"
click node_app "https://github.com/chevesqueaky/carai/blob/main/WebApp/__init__.py"
click node_routes "https://github.com/chevesqueaky/carai/blob/main/WebApp/route.py"
click node_car_ai "https://github.com/chevesqueaky/carai/blob/main/pythonApp/IA_car.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_runner,node_app,node_routes,node_user toneBlue
class node_car_ai toneAmber
```

## Components

### Web application

- [App runner](https://github.com/chevesqueaky/carai/blob/main/run.py): `run.py`
- [Web app](https://github.com/chevesqueaky/carai/blob/main/WebApp/__init__.py): `WebApp/__init__.py`
- [Route handlers](https://github.com/chevesqueaky/carai/blob/main/WebApp/route.py): `WebApp/route.py`

### Car AI

- [Car AI logic](https://github.com/chevesqueaky/carai/blob/main/pythonApp/IA_car.py): `pythonApp/IA_car.py`

### Other components

- **User**

## Connections

- App runner → Web app: starts (evidence: `run.py`)
- Web app → Route handlers: imports (evidence: `WebApp/__init__.py`)
- Route handlers → Car AI logic: may invoke
- User → App runner: initiates