# RenderParcel — Keramiek, drie lichtintenties

Versie van het dossier: **1.0.0**. Originele workflow om een creatief experiment op een andere machine te reconstrueren.

**Wat wordt geleverd:** een JSON van de ComfyUI 0.4-interface, 15 ingebouwde nodes, drie lichtvertakkingen, een exact manifest van het model en de softwarebronnen, een offline validator en een blanco vergelijkingsblad.

**Wat is gecontroleerd:** JSON-syntax, officieel schema UI 0.4, structuur van de nodes, verbindingstypes, graaf zonder cyclus, overeenstemmende parameters en bewust ingebrachte defaults. **ComfyUI is niet gestart; er is geen afbeelding gegenereerd en er is geen VRAM-behoefte of generatietijd gemeten.** Het importeren in een ComfyUI-interface en het uitvoeren op jouw omgeving moeten nog worden gecontroleerd. Het dossier bevat geen weights.

## 1. Het dossier controleren zonder ComfyUI

Pak het archief uit en open een terminal in `comfyui-v1`. Met Python 3.10 of nieuwer:

```console
python validate_workflow.py
```

De validator gebruikt alleen de standaardbibliotheek, neemt contact op met geen enkele server en start geen enkele AI-berekening. Het verwachte resultaat voor het intacte dossier bevat `ok: true`, `nodes: 15`, `links: 25`, `checkpoint_verified: false`, `comfyui_executed: false` en `image_generated: false`. Een fout geeft exitcode 1 en een uitleg. Deze validator controleert het precieze profiel van dit dossier, niet elke mogelijke ComfyUI-workflow.

## 2. De afhankelijkheden op de doelmachine verzamelen

De graaf is gebouwd op basis van de definities van **ComfyUI 0.37.0**, commit `73c9bad4d21e7addbe1d13bc92eee0f1431b017d`. De afhankelijkheden van deze versie verwijzen naar **comfyui-frontend-package 1.52.7**, frontend-commit `1a7a6b82514874545dc5e8203d0bd2188c2d9b18`. Dit zijn exacte documentatiereferenties, geen omgeving die in deze levering is geïnstalleerd en uitgevoerd. Een nieuwere versie kan het formaat importeren; die mogelijkheid geldt niet als validatie van het gedrag ervan.

Gebruik de [officiële installatie die bij jouw systeem past](https://docs.comfy.org/installation/manual_install). Vervang niet blindelings je productie-installatie. Noteer je daadwerkelijk gebruikte versies in `environnement-a-remplir.json`, met name Python, PyTorch, het stuurprogramma, de precisie en de opstartopties. Geen enkele Python/PyTorch voor generatie wordt hier als getest gepresenteerd.

Het enige vereiste model is **Stable Diffusion XL Base 1.0** van Stability AI:

- repository: `stabilityai/stable-diffusion-xl-base-1.0`;
- revisie: `462165984030d82259a11f4367a4eed129e94a7b`;
- bestand: `sd_xl_base_1.0.safetensors`;
- referentiegrootte: `6938078334` bytes, zonder direct verband met de piek-VRAM;
- referentie-SHA-256: `31e35c80fc4829d14f90153f4c74cd59c90b779f6afe05a74cd6120b893f7e5b`;
- beoogde locatie: `ComfyUI/models/checkpoints/sd_xl_base_1.0.safetensors`.

Bekijk het [bestand van de uitgever bij de vastgezette revisie](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/sd_xl_base_1.0.safetensors) en de [CreativeML Open RAIL++-M-licentie](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/LICENSE.md) voordat je het apart ophaalt. Het dossier voert geen enkele download uit. De vingerafdruk komt uit de LFS-metadata van de uitgever; deze is in deze levering niet opnieuw berekend op de weights.

Om het bestand dat je al hebt te vergelijken, zonder het in het GPU-geheugen te laden:

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

Deze optie leest het bestand om de grootte en de vingerafdruk te controleren. Dit kan tijd kosten, afhankelijk van de opslag. Een correcte vingerafdruk is geen bewijs van een geslaagde uitvoering. Geen enkele refiner, LoRA, ControlNet, invoerafbeelding of aangepaste node is vereist voor deze graaf.

## 3. De drie vertakkingen importeren en lezen

Open een voorbereide ComfyUI-installatie en importeer `workflow-ui.json` in de interface, door de workflow te openen of door de JSON naar het canvas te slepen. **Stuur dit bestand niet naar het API-eindpunt `/prompt`: het beschrijft de interface, niet de payload voor API-uitvoering.**

Controleer de keuze van het checkpoint in node 1. Als het bestand in een submap is geplaatst, selecteer je het werkelijke pad en behoud je deze wijziging in je kopie van het manifest. Als het menu het niet aanbiedt, controleer dan eerst de locatie en de extra paden van je installatie, en werk daarna de modellen bij of herstart volgens de procedure van je versie.

De branches A, B en C gebruiken hetzelfde fictieve object: een mat ivoorkleurige vaas op een kobaltblauwe sokkel, met een vrije zone voor een titel die later in opmaaksoftware wordt toegevoegd. De prompts zijn in het Engels voor dit SDXL-voorbeeld; de map legt hun rol in het Frans uit. Alleen de laatste zin van de positieve prompt varieert: zacht frontaal, links lateraal, tegenlicht.

De drie KSampler gebruiken `24092026`, controle na generatie `fixed`, 24 stappen, CFG 6.5, `euler`, `normal`, denoise 1. De gemeenschappelijke latent is 1024 × 1024 pixels met een batch van 1. Deze getallen definiëren de oefening; het zijn geen universeel optimale instellingen en geen prestatiemeting. Het recept bestuurt geen drie GPU's en stelt geen triptiek in één enkele afbeelding samen.

## 4. Uitvoeren en je resultaat beoordelen

Start een uitvoering wanneer de afhankelijkheden beschikbaar zijn. Elke branch moet zijn SaveImage-node bereiken. De prefixen zijn `RenderParcel/ceramique-v1/a_frontale`, `b_laterale` en `c_contrejour` in de uitvoermap van ComfyUI; ComfyUI voegt zijn bestandstellers toe. Drie branches garanderen geen gelijktijdige uitvoering.

Open de drie PNG's. Vul `comparaison.csv` in: leesbare rand, leesbaar materiaal, ruimte voor de titel, vervorming, gekozen variant en commentaar. De cellen zijn bewust leeg. Het licht kan ook het silhouet of de compositie veranderen: een gemeenschappelijke seed vergrendelt geen werkelijk object. Voor een getrouwe weergave van een product is deze text-to-image-map slechts een richtingstudie, geen procedé voor gecontroleerde reproductie.

De validatie op je machine is voltooid wanneer de bestanden bestaan, openen, de voorziene afmetingen hebben en aan je criteria voldoen. Noteer de omgeving, exporteer de gebruikte JSON en bewaar een referentiebeeld dat door je uitvoering is geproduceerd. Verzin geen duur of VRAM als je die niet hebt gemeten.

## 5. Herbouwen, wijzigen, overdragen

`reconstruction.md` detailleert elke verbinding en de volgorde van de widgets. Om het geval te wijzigen, dupliceer je de map, wijzig je één variabele tegelijk en werk je het manifest bij. De validator van profiel v1 kan een vrijwillige uitbreiding weigeren: dat bewijst niet dat ze ongeldig is voor ComfyUI, alleen dat ze buiten de gecontroleerde map valt.

Bewaar de JSON los van de PNG's. Ingesloten metadata kunnen worden verwijderd door een conversie of het delen. Archiveer ook je aangevulde manifest, de vergelijking en de geselecteerde uitvoer. De bibliotheken, gewichten en stuurprogramma's blijven afzonderlijke afhankelijkheden.

## Technische bronnen

- [UI-formaat ComfyUI 0.4](https://docs.comfy.org/specs/workflow_json_0.4).
- [Ingebouwde nodes, bron ComfyUI 0.37.0](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/nodes.py).
- [Afhankelijkheden van deze versie](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/requirements.txt).
- [Locatie van de modellen](https://docs.comfy.org/basic-concepts/models).
- [SDXL in ComfyUI, voorbeelden van de auteur](https://comfyanonymous.github.io/ComfyUI_examples/sdxl/).
- [Reproduceerbaarheidslimieten PyTorch](https://docs.pytorch.org/docs/2.14/notes/randomness.html).

De oorspronkelijke bronnen van de map vallen onder `LICENSE.md`. De software en het model behouden hun eigen licenties. Geen enkel bestand met account, betaling, identiteit, cookie of geheim is nodig voor dit project.

## Compatibiliteit van uitvoer v1

De nieuwe afbeeldingen gebruiken het prefix `RenderParcel/ceramique-v1/`. Geen enkele reeds aanwezige uitvoermap wordt verplaatst of verwijderd. De identifiers van de vijftien nodes, de links en de instellingen blijven identiek.

De validator accepteert ook het historische prefix `Prismora/ceramique-v1/`, met dezelfde variantnamen. Zo kan hij een oudere v1-workflow lezen met het huidige manifest; hij accepteert geen andere variantnaam. Reeds geproduceerde afbeeldingen behouden hun oorspronkelijke pad.