# deepratna-awale/autoexpress architecture

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

- Interactive diagram: https://gitdiagram.com/deepratna-awale/autoexpress
- Repository: https://github.com/deepratna-awale/autoexpress

## Overview

##### Project type and purpose
- AutoExpress is a full-stack Python web application (Flask) that provides a browser UI for uploading an image, generating 28 facial expressions by orchestrating calls to the Automatic1111 Stable Diffusion WebUI API (with the After Detailer extension), and compositing the results into an output grid.

##### File structure
Top-level directories & files:
- autoexpress/                 ← the main Python package
– create_grid.py            ← assembles the generated images into a grid
– views.py                  ← Flask route handlers
– modules/                  ← core processing components
- a1111_client.py         ← HTTP client for the SD WebUI API
- expression_generator.py ← logic to iterate expressions & build prompts
- image_parser.py         ← face detection/cropping
- background_remover.py   ← optional bg-removal pre-processing
- json_handler.py         ← builds/parses JSON payloads
- utils.py                ← shared utility functions
– resources/                ← static JSON definitions & sample images
– static/                   ← JS/CSS assets (UI logic & styling)
– templates/index.html      ← single-page UI layout
- run.sh / run.bat             ← startup scripts
- Dockerfile                   ← containerization
- requirements.txt             ← Python dependencies

##### README for additional insights
- Confirms Flask-based UI; reliance on A1111 WebUI API (http://127.0.0.1:7860) with Adetailer for inpainting.
- No database—images flow in memory.
- User drops image → UI auto-populates metadata → “Generate” triggers backend orchestration → final grid returned & displayed.

a. Main components
- User’s Browser (Front-end)
– HTML/CSS/JS assets: drag-and-drop, settings panel, Generate button, live logs/progress
- AutoExpress Web Server (Back-end)
– Flask Application (views.py)
– Processing Modules (image_parser, background_remover, expression_generator, a1111_client, create_grid)
– Resource Loader (loads JSON prompt templates & expressions lists)
- External AI Service
– A1111 Stable Diffusion WebUI API + After Detailer Extension

b. Relationships & data flow
1. Browser → (HTTP POST/AJAX) → Flask “/upload” endpoint (raw image + settings)
2. Flask calls image_parser → optional background_remover → expression_generator
3. expression_generator loops 28 expressions: for each, json_handler builds payload → a1111_client sends HTTP request to A1111 API
4. A1111 API returns inpainted image → a1111_client hands it back to create_grid
5. create_grid composes final grid image → Flask returns it to Browser
6. Browser displays grid, logs, allows download

c. Architectural patterns / design principles
- Modular separation of concerns: parsing, prompt generation, API client, grid assembly.
- Stateless request handling (no persistent storage).
- External service orchestration via REST.
- Single-page UI with asynchronous calls.

d. Key technologies/frameworks
- Python 3.x, Flask
- Automatic1111 WebUI REST API
- After Detailer Extension for inpainting
- Plain JS + AJAX for front-end interactivity
- Docker for containerization

##### Essential architectural details to capture
- Clear boundaries: UI vs. server vs. external AI
- Data flow steps (upload → parse → generate → assemble → display)
- Module responsibilities inside the Flask app
- No persistent storage—stateless, in-memory processing
- Docker container abstraction, if deploying via Docker

## Diagram (Mermaid)

```mermaid
graph TB
    %% Front-end Layer
    subgraph "Front-end (Browser)"
        UI["Browser UI\nHTML/CSS/JS"]:::frontend
    end

    %% Server Layer inside Docker
    subgraph "AutoExpress Server (Docker Container)"
        APP["Flask App\nviews.py"]:::backend

        subgraph "Processing Modules"
            Parser["Image Parser"]:::backend
            BGRemover["Background Remover"]:::backend
            ExprGen["Expression & Prompt Generator"]:::backend
            JSONH["JSON Handler"]:::backend
            Client["A1111 API Client"]:::backend
            Grid["Grid Composer"]:::backend
            Utils["Shared Utilities"]:::backend
            Resource["Resource Loader"]:::backend
        end
    end

    %% External AI Service
    External["A1111 Stable Diffusion API\n+ After Detailer"]:::external

    %% Deployment Infra
    subgraph "Deployment"
        DOCKER["Dockerfile & .dockerignore"]:::infra
        SCRIPTS["Startup Scripts"]:::infra
        REQ["requirements.txt"]:::infra
    end

    %% Data Flow
    UI -->|"POST /generate"| APP
    APP --> Parser
    Parser --> BGRemover
    BGRemover --> ExprGen
    ExprGen --> JSONH
    JSONH --> Client
    Client -->|"JSON payload"| External
    External -->|"Binary image data"| Client
    Client --> Grid
    Grid --> APP
    APP -->|"Grid image"| UI

    %% Utility & Resources
    APP --> Resource
    Parser --> Utils
    BGRemover --> Utils
    ExprGen --> Resource
    JSONH --> Resource

    %% Deployment Links
    DOCKER --> APP
    SCRIPTS --> APP
    REQ --> APP

    %% Click Events
    click UI "https://github.com/deepratna-awale/autoexpress/tree/main/autoexpress/static/js/"
    click UI "https://github.com/deepratna-awale/autoexpress/tree/main/autoexpress/static/stylesheet/"
    click UI "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/templates/index.html"
    click APP "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/views.py"
    click Grid "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/create_grid.py"
    click Parser "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/modules/image_parser.py"
    click BGRemover "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/modules/background_remover.py"
    click ExprGen "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/modules/expression_generator.py"
    click JSONH "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/modules/json_handler.py"
    click Client "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/modules/a1111_client.py"
    click Utils "https://github.com/deepratna-awale/autoexpress/blob/main/autoexpress/modules/utils.py"
    click Resource "https://github.com/deepratna-awale/autoexpress/tree/main/autoexpress/resources/"
    click DOCKER "https://github.com/deepratna-awale/autoexpress/tree/main/Dockerfile"
    click DOCKER "https://github.com/deepratna-awale/autoexpress/blob/main/.dockerignore"
    click SCRIPTS "https://github.com/deepratna-awale/autoexpress/blob/main/run.sh"
    click SCRIPTS "https://github.com/deepratna-awale/autoexpress/blob/main/run.bat"
    click REQ "https://github.com/deepratna-awale/autoexpress/blob/main/requirements.txt"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#000
    classDef backend fill:#90EE90,stroke:#000
    classDef external fill:#FFA500,stroke:#000
    classDef infra fill:#D3D3D3,stroke:#000
```
