# mwasifanwar/neurofabric-ai architecture

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

- Interactive diagram: https://gitdiagram.com/mwasifanwar/neurofabric-ai
- Repository: https://github.com/mwasifanwar/neurofabric-ai

## Overview

##### Project Type and Purpose
- neurofabric-ai is a backend ML service for real-time computer vision on textile production lines. It has no frontend GUI; instead it exposes an HTTP API for:
- Defect detection in live fabric streams
- Fabric analysis metrics
- Generative design of new fabric patterns via GANs

##### High-Level Architecture
- External Clients (Manufacturing Cameras, Monitoring Dashboards)
- API Layer (FastAPI or Flask in run_api.py/main.py)
- Core Processing Pipeline (fabric_analyzer → defect_detector → quality_controller → design_generator)
- Model Store (CNN and GAN model definitions & weights)
- Utility Services (image preprocessing, data loading, visualization)
- Configuration (model parameters, settings)
- Tests (unit & integration)

##### Main Components & Their Relationships
a. API Layer
– Entry point: run_api.py / main.py
– Routes: api/routes.py
– Middleware (authentication, logging): api/middleware.py
– Delegates requests to Core Processing Pipeline
b. Core Processing Pipeline
– fabric_analyzer: extracts metrics from raw images
– defect_detector: applies CNN models to find defects
– quality_controller: aggregates results, enforces thresholds
– design_generator: uses GAN models to produce new designs
c. Model Store
– cnn_models.py, gan_models.py define architecture and load weights
– config/model_config.py specifies paths, hyperparameters
d. Utilities
– data_loader.py: ingest streaming or batch image data
– image_processor.py: resize, normalize, augment images
– visualization.py: render detection overlays or design previews
e. Configuration
– config/settings.py: global settings (e.g., API ports, log levels)
– config/model_config.py: model-specific settings
f. Tests
– tests/test_defect_detector.py, test_fabric_analyzer.py, test_integration.py validate functionality

##### Key Architectural Patterns
- Layered Architecture: clear separation between API, core business logic, model layer, and utils
- Pipeline Pattern: sequential processing stages for image data
- Config-Driven: decouple hard-coded parameters into config modules
- Modular ML: separate CNN vs. GAN submodules for reuse and testing

##### Final Checklist
- Annotations for frameworks & libraries

## Diagram (Mermaid)

```mermaid
graph TB
    %% External Clients
    ExternalClients["Manufacturing Cameras\n& Monitoring Dashboards"]:::external

    %% API Layer
    subgraph "API Layer"
        RunAPI["run_api.py\n(FastAPI/Flask)"]:::api
        Main["main.py\n(FastAPI/Flask)"]:::api
        Routes["api/routes.py"]:::api
        Middleware["api/middleware.py"]:::api
    end

    %% Core Processing Pipeline
    subgraph "Core Processing Pipeline"
        FabricAnalyzer["fabric_analyzer.py\n(extract metrics)"]:::processing
        DefectDetector["defect_detector.py\n(CNN inference)"]:::processing
        QualityController["quality_controller.py\n(aggregate thresholds)"]:::processing
        DesignGenerator["design_generator.py\n(GAN generation)"]:::processing
    end

    %% Model Store
    subgraph "Model Store"
        CNNModels["cnn_models.py\n(PyTorch/TensorFlow)"]:::models
        GANModels["gan_models.py\n(PyTorch/TensorFlow)"]:::models
    end

    %% Utilities
    subgraph "Utilities"
        DataLoader["utils/data_loader.py\n(OpenCV, NumPy)"]:::utils
        ImageProcessor["utils/image_processor.py\n(OpenCV, PIL)"]:::utils
        Visualization["utils/visualization.py\n(render overlays)"]:::utils
    end

    %% Configuration
    subgraph "Configuration"
        ModelConfig["config/model_config.py\n(YAML/Python)"]:::config
        Settings["config/settings.py\n(global settings)"]:::config
    end

    %% Tests
    subgraph "Tests"
        direction TB
        TestDefect["tests/test_defect_detector.py"]:::tests
        TestFabric["tests/test_fabric_analyzer.py"]:::tests
        TestIntegration["tests/test_integration.py"]:::tests
    end

    %% Connections
    ExternalClients -->|HTTP| RunAPI
    ExternalClients -->|HTTP| Main
    RunAPI --> Routes
    Main --> Routes
    Routes --> Middleware
    Middleware --> FabricAnalyzer

    FabricAnalyzer --> DefectDetector
    DefectDetector --> QualityController
    QualityController --> DesignGenerator

    FabricAnalyzer -->|loads model| CNNModels
    DefectDetector -->|loads model| CNNModels
    QualityController -->|uses thresholds| ModelConfig
    DesignGenerator -->|loads model| GANModels

    DataLoader --> FabricAnalyzer
    ImageProcessor --> FabricAnalyzer
    FabricAnalyzer --> Visualization
    DesignGenerator --> Visualization

    ModelConfig --> RunAPI
    ModelConfig --> FabricAnalyzer
    Settings --> RunAPI
    Settings --> FabricAnalyzer

    FabricAnalyzer --> TestFabric
    DefectDetector --> TestDefect
    DesignGenerator --> TestIntegration

    %% Click Events
    click RunAPI "https://github.com/mwasifanwar/neurofabric-ai/blob/main/run_api.py"
    click Main "https://github.com/mwasifanwar/neurofabric-ai/blob/main/main.py"
    click Routes "https://github.com/mwasifanwar/neurofabric-ai/blob/main/api/routes.py"
    click Middleware "https://github.com/mwasifanwar/neurofabric-ai/blob/main/api/middleware.py"
    click FabricAnalyzer "https://github.com/mwasifanwar/neurofabric-ai/blob/main/core/fabric_analyzer.py"
    click DefectDetector "https://github.com/mwasifanwar/neurofabric-ai/blob/main/core/defect_detector.py"
    click QualityController "https://github.com/mwasifanwar/neurofabric-ai/blob/main/core/quality_controller.py"
    click DesignGenerator "https://github.com/mwasifanwar/neurofabric-ai/blob/main/core/design_generator.py"
    click CNNModels "https://github.com/mwasifanwar/neurofabric-ai/blob/main/models/cnn_models.py"
    click GANModels "https://github.com/mwasifanwar/neurofabric-ai/blob/main/models/gan_models.py"
    click ModelConfig "https://github.com/mwasifanwar/neurofabric-ai/blob/main/config/model_config.py"
    click Settings "https://github.com/mwasifanwar/neurofabric-ai/blob/main/config/settings.py"
    click DataLoader "https://github.com/mwasifanwar/neurofabric-ai/blob/main/utils/data_loader.py"
    click ImageProcessor "https://github.com/mwasifanwar/neurofabric-ai/blob/main/utils/image_processor.py"
    click Visualization "https://github.com/mwasifanwar/neurofabric-ai/blob/main/utils/visualization.py"
    click TestDefect "https://github.com/mwasifanwar/neurofabric-ai/blob/main/tests/test_defect_detector.py"
    click TestFabric "https://github.com/mwasifanwar/neurofabric-ai/blob/main/tests/test_fabric_analyzer.py"
    click TestIntegration "https://github.com/mwasifanwar/neurofabric-ai/blob/main/tests/test_integration.py"

    %% Styles
    classDef api fill:#E3F2FD,stroke:#90CAF9,color:#0D47A1
    classDef processing fill:#FFF3E0,stroke:#FFB300,color:#E65100
    classDef models fill:#E8F5E9,stroke:#66BB6A,color:#1B5E20
    classDef utils fill:#F3E5F5,stroke:#AB47BC,color:#4A148C
    classDef config fill:#FFEBEE,stroke:#EF5350,color:#B71C1C
    classDef tests fill:#ECEFF1,stroke:#90A4AE,color:#455A64,stroke-dasharray:5 5
    classDef external fill:#FFFFFF,stroke:#000000,color:#000000
```
