# sullichrosu/njobvu-ai architecture

> Architecture diagram of the GitHub repository sullichrosu/njobvu-ai, 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/sullichrosu/njobvu-ai
- Repository: https://github.com/sullichrosu/njobvu-ai

## Overview

Njobvu-AI is a collaborative computer-vision labeling and model workflow application. Users create or import image projects, annotate and review labels, train models, run inference on new images, and download datasets or run artifacts. The graph shows the Express entry points, project and label data access, and the documented training, inference, validation, and export capabilities. Some feature links are documented only at the route level; unsampled implementation details and their internal call paths are not inferred.

Main entry points: [`routes/api.js`](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/api.js) (API routing), [`queries/queries.js`](https://github.com/sullichrosu/njobvu-ai/blob/main/queries/queries.js) (Query facade), [`routes/inference/yoloInference.js`](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/inference/yoloInference.js) (Inference routes), [`routes/training/yoloRun.js`](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/training/yoloRun.js) (Model training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_server["HTTP server<br/>[server.js]"]
  node_app["Express app<br/>[app.js]"]
  node_api["API routing<br/>[api.js]"]
  node_pages["Page routing<br/>[pages.js]"]
end

subgraph group_projects["Projects and labeling"]
  node_project_ops["Project operations"]
  node_label_ops["Label operations"]
  node_validation["Validation workflow"]
  node_downloads["Dataset and run downloads"]
end

subgraph group_ml["Model workflows"]
  node_training["Model training<br/>[yoloRun.js]"]
  node_train_prep["Training image prep"]
  node_inference["Inference routes<br/>[yoloInference.js]"]
  node_inception["Inception inference"]
  node_detector["Megadetector inference"]
  node_dataset_prep["Inference dataset prep"]
end

subgraph group_data["Data and storage"]
  node_project_db[("Project data<br/>[projects.js]")]
  node_label_db[("Annotations and images<br/>[labelling.js]")]
  node_query_api["Query facade<br/>[queries.js]"]
  node_db_client["SQLite client<br/>[client.js]"]
  node_s3["S3 access<br/>[s3Client.js]"]
end

subgraph group_support["Runs and integrations"]
  node_chat["Ollama chat<br/>[ollamaChat.js]"]
  node_run_tools["Run summaries"]
  node_sandbox["Python sandbox"]
  node_rimraf["File removal utility<br/>[rimraf.js]"]
end

node_user(("Collaborative user"))

node_user -->|"uses"| node_server
node_server -->|"serves"| node_app
node_app -->|"mounts"| node_api
node_app -->|"routes pages"| node_pages
node_api -->|"routes project actions"| node_project_ops
node_api -->|"routes label actions"| node_label_ops
node_api -->|"routes validation"| node_validation
node_api -->|"routes training"| node_training
node_api -->|"routes inference"| node_inference
node_api -->|"routes chat"| node_chat
node_pages -.->|"renders training view"| node_training
node_pages -->|"renders inference view"| node_inference
node_project_ops -.->|"uses project queries"| node_query_api
node_label_ops -.->|"uses label queries"| node_query_api
node_validation -.->|"uses validation queries"| node_query_api
node_query_api -->|"combines queries"| node_project_db
node_query_api -->|"combines queries"| node_label_db
node_query_api -->|"gets project client"| node_db_client
node_training -->|"uses project queries"| node_query_api
node_training -->|"prepares images"| node_train_prep
node_inference -->|"uses project queries"| node_query_api
node_inference -->|"prepares dataset"| node_dataset_prep
node_inception -->|"prepares dataset"| node_dataset_prep
node_dataset_prep -->|"looks up bucket"| node_query_api
node_dataset_prep -->|"lists and downloads"| node_s3
node_inference -.->|"optional model route"| node_inception
node_api -.->|"routes inference"| node_detector
node_downloads -->|"uses project queries"| node_query_api
node_downloads -->|"uses S3 access"| node_s3
node_chat -->|"uses project queries"| node_query_api
node_chat -->|"uses run summaries"| node_run_tools
node_sandbox -->|"summarizes runs"| node_run_tools
node_api -->|"routes sandbox"| node_sandbox
node_api -->|"imports utility"| node_rimraf

click node_server "https://github.com/sullichrosu/njobvu-ai/blob/main/server.js"
click node_app "https://github.com/sullichrosu/njobvu-ai/blob/main/app.js"
click node_api "https://github.com/sullichrosu/njobvu-ai/blob/main/routes/api.js"
click node_pages "https://github.com/sullichrosu/njobvu-ai/blob/main/routes/pages.js"
click node_project_ops "https://github.com/sullichrosu/njobvu-ai/tree/main/routes/projects"
click node_label_ops "https://github.com/sullichrosu/njobvu-ai/tree/main/routes/labelling"
click node_validation "https://github.com/sullichrosu/njobvu-ai/tree/main/routes/validation"
click node_project_db "https://github.com/sullichrosu/njobvu-ai/blob/main/queries/projects/projects.js"
click node_label_db "https://github.com/sullichrosu/njobvu-ai/blob/main/queries/labelling/labelling.js"
click node_query_api "https://github.com/sullichrosu/njobvu-ai/blob/main/queries/queries.js"
click node_db_client "https://github.com/sullichrosu/njobvu-ai/blob/main/queries/client.js"
click node_training "https://github.com/sullichrosu/njobvu-ai/blob/main/routes/training/yoloRun.js"
click node_train_prep "https://github.com/sullichrosu/njobvu-ai/blob/main/utils/jitTrainingImages.js"
click node_inference "https://github.com/sullichrosu/njobvu-ai/blob/main/routes/inference/yoloInference.js"
click node_inception "https://github.com/sullichrosu/njobvu-ai/blob/main/routes/inference/inceptionInference.js"
click node_detector "https://github.com/sullichrosu/njobvu-ai/blob/main/routes/inference/megadetectorInference.js"
click node_dataset_prep "https://github.com/sullichrosu/njobvu-ai/blob/main/utils/inferenceDatasetPipeline.js"
click node_downloads "https://github.com/sullichrosu/njobvu-ai/tree/main/routes/downloads"
click node_s3 "https://github.com/sullichrosu/njobvu-ai/blob/main/utils/s3Client.js"
click node_chat "https://github.com/sullichrosu/njobvu-ai/blob/main/routes/chat/ollamaChat.js"
click node_run_tools "https://github.com/sullichrosu/njobvu-ai/blob/main/utils/runSummaryGenerator.js"
click node_sandbox "https://github.com/sullichrosu/njobvu-ai/blob/main/utils/sandboxedPythonRunner.js"
click node_rimraf "https://github.com/sullichrosu/njobvu-ai/blob/main/public/libraries/rimraf.js"

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_server,node_app,node_api,node_pages,node_user toneBlue
class node_project_ops,node_label_ops,node_validation,node_downloads toneAmber
class node_training,node_train_prep,node_inference,node_inception,node_detector,node_dataset_prep toneMint
class node_project_db,node_label_db,node_query_api,node_db_client,node_s3 toneRose
class node_chat,node_run_tools,node_sandbox,node_rimraf toneIndigo
```

## Components

### Web application

- [HTTP server](https://github.com/sullichrosu/njobvu-ai/blob/main/server.js): `server.js`
- [Express app](https://github.com/sullichrosu/njobvu-ai/blob/main/app.js): `app.js`
- [API routing](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/api.js): `routes/api.js`
- [Page routing](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/pages.js): `routes/pages.js`

### Projects and labeling

- [Project operations](https://github.com/sullichrosu/njobvu-ai/tree/main/routes/projects): `routes/projects`
- [Label operations](https://github.com/sullichrosu/njobvu-ai/tree/main/routes/labelling): `routes/labelling`
- [Validation workflow](https://github.com/sullichrosu/njobvu-ai/tree/main/routes/validation): `routes/validation`
- [Dataset and run downloads](https://github.com/sullichrosu/njobvu-ai/tree/main/routes/downloads): `routes/downloads`

### Model workflows

- [Model training](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/training/yoloRun.js): `routes/training/yoloRun.js`
- [Training image prep](https://github.com/sullichrosu/njobvu-ai/blob/main/utils/jitTrainingImages.js): `utils/jitTrainingImages.js`
- [Inference routes](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/inference/yoloInference.js): `routes/inference/yoloInference.js`
- [Inception inference](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/inference/inceptionInference.js): `routes/inference/inceptionInference.js`
- [Megadetector inference](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/inference/megadetectorInference.js): `routes/inference/megadetectorInference.js`
- [Inference dataset prep](https://github.com/sullichrosu/njobvu-ai/blob/main/utils/inferenceDatasetPipeline.js): `utils/inferenceDatasetPipeline.js`

### Data and storage

- [Project data](https://github.com/sullichrosu/njobvu-ai/blob/main/queries/projects/projects.js): `queries/projects/projects.js`
- [Annotations and images](https://github.com/sullichrosu/njobvu-ai/blob/main/queries/labelling/labelling.js): `queries/labelling/labelling.js`
- [Query facade](https://github.com/sullichrosu/njobvu-ai/blob/main/queries/queries.js): `queries/queries.js`
- [SQLite client](https://github.com/sullichrosu/njobvu-ai/blob/main/queries/client.js): `queries/client.js`
- [S3 access](https://github.com/sullichrosu/njobvu-ai/blob/main/utils/s3Client.js): `utils/s3Client.js`

### Runs and integrations

- [Ollama chat](https://github.com/sullichrosu/njobvu-ai/blob/main/routes/chat/ollamaChat.js): `routes/chat/ollamaChat.js`
- [Run summaries](https://github.com/sullichrosu/njobvu-ai/blob/main/utils/runSummaryGenerator.js): `utils/runSummaryGenerator.js`
- [Python sandbox](https://github.com/sullichrosu/njobvu-ai/blob/main/utils/sandboxedPythonRunner.js): `utils/sandboxedPythonRunner.js`
- [File removal utility](https://github.com/sullichrosu/njobvu-ai/blob/main/public/libraries/rimraf.js): `public/libraries/rimraf.js`

### Other components

- **Collaborative user**

## Connections

- Collaborative user → HTTP server: uses
- HTTP server → Express app: serves (evidence: `server.js`)
- Express app → API routing: mounts (evidence: `app.js`)
- Express app → Page routing: routes pages (evidence: `app.js`)
- API routing → Project operations: routes project actions (evidence: `routes/api.js`)
- API routing → Label operations: routes label actions (evidence: `routes/api.js`)
- API routing → Validation workflow: routes validation (evidence: `routes/api.js`)
- API routing → Model training: routes training (evidence: `routes/api.js`)
- API routing → Inference routes: routes inference (evidence: `routes/api.js`)
- API routing → Ollama chat: routes chat (evidence: `routes/api.js`)
- Page routing → Model training: renders training view
- Page routing → Inference routes: renders inference view (evidence: `routes/pages.js`)
- Project operations → Query facade: uses project queries (evidence: `routes/projects/toggleAllReview.js`)
- Label operations → Query facade: uses label queries
- Validation workflow → Query facade: uses validation queries
- Query facade → Project data: combines queries (evidence: `queries/queries.js`)
- Query facade → Annotations and images: combines queries (evidence: `queries/queries.js`)
- Query facade → SQLite client: gets project client (evidence: `queries/queries.js`)
- Model training → Query facade: uses project queries (evidence: `routes/training/yoloRun.js`)
- Model training → Training image prep: prepares images (evidence: `routes/training/yoloRun.js`)
- Inference routes → Query facade: uses project queries (evidence: `routes/inference/yoloInference.js`)
- Inference routes → Inference dataset prep: prepares dataset (evidence: `routes/inference/yoloInference.js`)
- Inception inference → Inference dataset prep: prepares dataset (evidence: `routes/inference/inceptionInference.js`)
- Inference dataset prep → Query facade: looks up bucket (evidence: `utils/inferenceDatasetPipeline.js`)
- Inference dataset prep → S3 access: lists and downloads (evidence: `utils/inferenceDatasetPipeline.js`)
- Inference routes → Inception inference: optional model route
- API routing → Megadetector inference: routes inference
- Dataset and run downloads → Query facade: uses project queries (evidence: `routes/downloads/downloadDataset.js`)
- Dataset and run downloads → S3 access: uses S3 access (evidence: `routes/downloads/downloadDataset.js`)
- Ollama chat → Query facade: uses project queries (evidence: `routes/chat/ollamaChat.js`)
- Ollama chat → Run summaries: uses run summaries (evidence: `routes/chat/ollamaChat.js`)
- Python sandbox → Run summaries: summarizes runs (evidence: `controllers/sandboxController.js`)
- API routing → Python sandbox: routes sandbox (evidence: `routes/api.js`)
- API routing → File removal utility: imports utility (evidence: `routes/api.js`)
