# RenderParcel — Ceramica, tre intenzioni di luce

Versione del dossier: **1.0.0**. Workflow originale per ricostruire un esperimento creativo su un'altra macchina.

**Cosa viene consegnato:** un JSON dell'interfaccia ComfyUI 0.4, 15 nodi integrati, tre rami di luce, un manifesto esatto del modello e delle fonti software, un validatore offline e un foglio di confronto vuoto.

**Cosa è stato controllato:** sintassi JSON, schema ufficiale UI 0.4, struttura dei nodi, tipi di connessioni, grafo senza cicli, parametri concordanti e default introdotti volutamente. **ComfyUI non è stato avviato; nessuna immagine è stata generata, nessun fabbisogno di VRAM né tempo di generazione è stato misurato.** L'import in un'interfaccia ComfyUI e l'esecuzione nel tuo ambiente restano da controllare. Il dossier non contiene alcun peso.

## 1. Verificare il dossier senza ComfyUI

Decomprimi l'archivio e apri un terminale in `comfyui-v1`. Con Python 3.10 o più recente:

```console
python validate_workflow.py
```

Il validatore utilizza solo la libreria standard, non contatta alcun server e non avvia alcun calcolo IA. Il risultato atteso per il dossier intatto contiene `ok: true`, `nodes: 15`, `links: 25`, `checkpoint_verified: false`, `comfyui_executed: false` e `image_generated: false`. Un fallimento restituisce un codice di uscita 1 e una spiegazione. Questo validatore controlla il profilo preciso di questo dossier, non qualsiasi workflow ComfyUI possibile.

## 2. Riunire le dipendenze sulla macchina di destinazione

Il grafo è stato costruito a partire dalle definizioni di **ComfyUI 0.37.0**, commit `73c9bad4d21e7addbe1d13bc92eee0f1431b017d`. Le dipendenze di questa versione indicano **comfyui-frontend-package 1.52.7**, commit frontend `1a7a6b82514874545dc5e8203d0bd2188c2d9b18`. Sono riferimenti documentali esatti, non un ambiente installato ed eseguito in questa consegna. Una versione più recente può importare il formato; questa possibilità non equivale a una validazione del suo comportamento.

Usa l'[installazione ufficiale adatta al tuo sistema](https://docs.comfy.org/installation/manual_install). Non sostituire alla cieca la tua installazione di produzione. Rileva le versioni effettivamente utilizzate in `environnement-a-remplir.json`, in particolare Python, PyTorch, il driver, la precisione e le opzioni di avvio. Nessun Python/PyTorch di generazione è presentato come testato qui.

L'unico modello richiesto è **Stable Diffusion XL Base 1.0** di Stability AI:

- repository: `stabilityai/stable-diffusion-xl-base-1.0`;
- revisione: `462165984030d82259a11f4367a4eed129e94a7b`;
- file: `sd_xl_base_1.0.safetensors`;
- dimensione di riferimento: `6938078334` byte, senza rapporto diretto con il picco di VRAM;
- SHA-256 di riferimento: `31e35c80fc4829d14f90153f4c74cd59c90b779f6afe05a74cd6120b893f7e5b`;
- posizione prevista: `ComfyUI/models/checkpoints/sd_xl_base_1.0.safetensors`.

Consulta il [file dell'editore alla revisione fissata](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/sd_xl_base_1.0.safetensors) e la sua [licenza CreativeML Open RAIL++-M](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/LICENSE.md) prima di ottenerlo separatamente. Il dossier non effettua alcun download. L'impronta proviene dai metadati LFS dell'editore; non è stata ricalcolata sui pesi in questa consegna.

Per confrontare il file che possiedi già, senza caricarlo in memoria GPU:

```console
python validate_workflow.py --checkpoint "D:/modeles/sd_xl_base_1.0.safetensors"
```

Questa opzione legge il file per verificarne la dimensione e l'impronta. Può richiedere tempo a seconda dello storage. Un'impronta corretta non è una prova di esecuzione riuscita. Nessun refiner, LoRA, ControlNet, immagine di input o nodo personalizzato è richiesto da questo grafo.

## 3. Importare e leggere i tre rami

Apri un'installazione ComfyUI preparata, poi importa `workflow-ui.json` nell'interfaccia, aprendo il workflow o trascinando il JSON sul canvas. **Non inviare questo file all'endpoint API `/prompt`: descrive l'interfaccia, non il payload di esecuzione API.**

Verifica la scelta del checkpoint nel nodo 1. Se il file è stato inserito in una sottocartella, seleziona il suo percorso reale e conserva questa modifica nella tua copia del manifest. Se il menu non lo propone, controlla prima la sua posizione e i percorsi aggiuntivi della tua installazione, poi aggiorna i modelli o riavvia seguendo la procedura della tua versione.

I rami A, B e C riprendono lo stesso oggetto fittizio: un vaso avorio opaco su un basamento blu cobalto, con una zona libera prevista per un titolo aggiunto in seguito in un software di impaginazione. I prompt sono in inglese per questo esempio SDXL; la cartella ne spiega il ruolo in francese. Solo l'ultima frase del prompt positivo varia: frontale morbida, laterale sinistra, controluce.

I tre KSampler usano `24092026`, controllo dopo la generazione `fixed`, 24 passi, CFG 6.5, `euler`, `normal`, denoise 1. Il latente comune è di 1024 × 1024 pixel con un batch di 1. Questi numeri definiscono l'esercizio; non sono né un'impostazione ottimale universale né una misura di prestazioni. La ricetta non pilota tre GPU e non assembla un trittico in un'unica immagine.

## 4. Eseguire e giudicare il tuo risultato

Avvia un'esecuzione quando le dipendenze sono disponibili. Ogni ramo deve raggiungere il suo nodo SaveImage. I prefissi sono `RenderParcel/ceramique-v1/a_frontale`, `b_laterale` e `c_contrejour` nella directory di output di ComfyUI; ComfyUI aggiunge i suoi contatori di file. Tre rami non garantiscono un'esecuzione simultanea.

Apri i tre PNG. Compila `comparaison.csv`: bordo leggibile, materia leggibile, spazio per il titolo, deformazione, variante scelta e commento. Le celle sono volutamente vuote. La luce può anche cambiare la silhouette o la composizione: un seed comune non blocca un oggetto reale. Per una rappresentazione fedele di un prodotto, questa cartella text-to-image è solo uno studio di direzione, non un procedimento di riproduzione controllata.

La validazione sulla tua macchina è terminata quando i file esistono, si aprono, hanno le dimensioni previste e rispondono ai tuoi criteri. Rileva l'ambiente, esporta il JSON utilizzato e conserva un'immagine testimone prodotta dalla tua esecuzione. Non inventare una durata o una VRAM se non l'hai misurata.

## 5. Ricostruire, modificare, trasmettere

`reconstruction.md` dettaglia ogni connessione e l'ordine dei widget. Per modificare il caso, duplica la cartella, cambia una variabile alla volta e aggiorna il manifest. Il validatore del profilo v1 può rifiutare un'estensione volontaria: ciò non prova che sia invalida per ComfyUI, solo che esce dalla cartella controllata.

Conserva il JSON indipendentemente dai PNG. I metadati incorporati possono essere rimossi da una conversione o da una condivisione. Archivia anche il tuo manifest compilato, il confronto e gli output selezionati. Le librerie, i pesi e i driver restano dipendenze distinte.

## Fonti tecniche

- [Formato UI ComfyUI 0.4](https://docs.comfy.org/specs/workflow_json_0.4).
- [Nodi integrati, sorgente ComfyUI 0.37.0](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/nodes.py).
- [Dipendenze di questa versione](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/requirements.txt).
- [Posizione dei modelli](https://docs.comfy.org/basic-concepts/models).
- [SDXL in ComfyUI, esempi dell'autore](https://comfyanonymous.github.io/ComfyUI_examples/sdxl/).
- [Limiti di riproducibilità PyTorch](https://docs.pytorch.org/docs/2.14/notes/randomness.html).

Le risorse originali della cartella rientrano in `LICENSE.md`. I software e il modello mantengono le proprie licenze. Nessun file di account, pagamento, identità, cookie o segreto è necessario per questo progetto.

## Compatibilità degli output v1

Le nuove immagini usano il prefisso `RenderParcel/ceramique-v1/`. Nessuna cartella di output già presente viene spostata o eliminata. Gli identificatori dei quindici nodi, i collegamenti e le impostazioni restano identici.

Il validatore accetta anche il prefisso storico `Prismora/ceramique-v1/`, con gli stessi nomi di variante. Può così leggere un workflow v1 precedente con il manifest attuale; non accetta un nome di variante diverso. Le immagini già prodotte conservano il loro percorso originale.