# jceronch1/qwen-imagen-studio architecture

> Architecture diagram of the GitHub repository jceronch1/qwen-imagen-studio, 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/jceronch1/qwen-imagen-studio
- Repository: https://github.com/jceronch1/qwen-imagen-studio

## Overview

Qwen Imagen Studio es un estudio web local para generar imágenes y editarlas con hasta dos referencias. El flujo principal va del usuario y la interfaz a la solicitud validada, la selección/preparación del motor y la generación; el servidor guarda imágenes y parámetros para la biblioteca local. El motor admite CPU, GPU y modo híbrido, con diagnóstico de errores. La fusión opcional del LoRA y el lector GGUF son una rama de preparación del modelo. Algunas rutas dinámicas de API y partes de la generación no aparecen en los extractos, así que esas conexiones se indican como no verificadas.

Main entry points: [`scripts/server.mjs`](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/server.mjs) (Servidor local), [`scripts/engine-manager.mjs`](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/engine-manager.mjs) (Gestión del motor), [`scripts/merge-lora.mjs`](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/merge-lora.mjs) (Fusión de LoRA), [`app/app.js`](https://github.com/jceronch1/qwen-imagen-studio/blob/main/app/app.js) (Interfaz de creación)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_studio["Estudio web"]
  node_webui["Interfaz de creación<br/>[app.js]"]
end

subgraph group_runtime["Generación local"]
  node_server["Servidor local<br/>[server.mjs]"]
  node_validation["Validación y payload<br/>[core.mjs]"]
  node_manager["Gestión del motor<br/>[engine-manager.mjs]"]
  node_diagnostics["Diagnóstico de fallos"]
end

subgraph group_library["Biblioteca local"]
  node_outputs[("Imágenes y metadatos<br/>[server.mjs]")]
  node_gallery["Biblioteca y papelera<br/>[server.mjs]"]
end

subgraph group_modelprep["Preparación del modelo"]
  node_modelconfig["Configuración de modelos<br/>[model-config.json]"]
  node_merge["Fusión de LoRA<br/>[merge-lora.mjs]"]
  node_gguf["Lectura y escritura GGUF<br/>[gguf.mjs]"]
  node_models[("Modelos y adaptadores")]
end

node_user(("Usuario"))
node_engine["Motor de difusión"]

node_user -->|"crea y edita"| node_webui
node_webui -.->|"envía solicitudes"| node_server
node_server -->|"valida entradas"| node_validation
node_server -->|"prepara motor"| node_manager
node_server -->|"diagnostica fallos"| node_diagnostics
node_manager -->|"inicia y configura"| node_engine
node_engine -.->|"devuelve resultados"| node_server
node_server -->|"guarda imágenes"| node_outputs
node_server -->|"sirve y elimina"| node_gallery
node_gallery -.->|"lee archivos"| node_outputs
node_merge -->|"usa codecs"| node_gguf
node_merge -->|"fusiona pesos"| node_models
node_manager -->|"carga modelos"| node_models
node_validation -->|"lee configuración"| node_modelconfig

click node_webui "https://github.com/jceronch1/qwen-imagen-studio/blob/main/app/app.js"
click node_server "https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/server.mjs"
click node_validation "https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/core.mjs"
click node_manager "https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/engine-manager.mjs"
click node_diagnostics "https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/engine-diagnostics.mjs"
click node_outputs "https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/server.mjs"
click node_gallery "https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/server.mjs"
click node_modelconfig "https://github.com/jceronch1/qwen-imagen-studio/blob/main/model-config.json"
click node_merge "https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/merge-lora.mjs"
click node_gguf "https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/gguf.mjs"
click node_models "https://github.com/jceronch1/qwen-imagen-studio/tree/main/models"

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_webui toneBlue
class node_server,node_validation,node_manager,node_diagnostics toneAmber
class node_outputs,node_gallery toneMint
class node_modelconfig,node_merge,node_gguf,node_models toneRose
class node_user,node_engine toneIndigo
```

## Components

### Estudio web

- [Interfaz de creación](https://github.com/jceronch1/qwen-imagen-studio/blob/main/app/app.js): `app/app.js`

### Generación local

- [Servidor local](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/server.mjs): `scripts/server.mjs`
- [Validación y payload](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/core.mjs): `scripts/core.mjs`
- [Gestión del motor](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/engine-manager.mjs): `scripts/engine-manager.mjs`
- [Diagnóstico de fallos](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/engine-diagnostics.mjs): `scripts/engine-diagnostics.mjs`

### Biblioteca local

- [Imágenes y metadatos](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/server.mjs): `scripts/server.mjs`
- [Biblioteca y papelera](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/server.mjs): `scripts/server.mjs`

### Preparación del modelo

- [Configuración de modelos](https://github.com/jceronch1/qwen-imagen-studio/blob/main/model-config.json): `model-config.json`
- [Fusión de LoRA](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/merge-lora.mjs): `scripts/merge-lora.mjs`
- [Lectura y escritura GGUF](https://github.com/jceronch1/qwen-imagen-studio/blob/main/scripts/gguf.mjs): `scripts/gguf.mjs`
- [Modelos y adaptadores](https://github.com/jceronch1/qwen-imagen-studio/tree/main/models): `models`

### Other components

- **Usuario**
- **Motor de difusión**

## Connections

- Usuario → Interfaz de creación: crea y edita (evidence: `README.md`)
- Interfaz de creación → Servidor local: envía solicitudes
- Servidor local → Validación y payload: valida entradas (evidence: `scripts/server.mjs`)
- Servidor local → Gestión del motor: prepara motor (evidence: `scripts/server.mjs`)
- Servidor local → Diagnóstico de fallos: diagnostica fallos (evidence: `scripts/server.mjs`)
- Gestión del motor → Motor de difusión: inicia y configura (evidence: `scripts/engine-manager.mjs`)
- Motor de difusión → Servidor local: devuelve resultados
- Servidor local → Imágenes y metadatos: guarda imágenes (evidence: `scripts/server.mjs`)
- Servidor local → Biblioteca y papelera: sirve y elimina (evidence: `scripts/server.mjs`)
- Biblioteca y papelera → Imágenes y metadatos: lee archivos (evidence: `scripts/server.mjs`)
- Fusión de LoRA → Lectura y escritura GGUF: usa codecs (evidence: `scripts/merge-lora.mjs`)
- Fusión de LoRA → Modelos y adaptadores: fusiona pesos (evidence: `scripts/merge-lora.mjs`)
- Gestión del motor → Modelos y adaptadores: carga modelos (evidence: `scripts/engine-manager.mjs`)
- Validación y payload → Configuración de modelos: lee configuración (evidence: `scripts/core.mjs`)
