# RenderParcel — Cerâmica, três intenções de luz

Versão do pacote: **1.0.0**. Workflow original para reconstruir um ensaio criativo em outra máquina.

**O que é entregue:** um JSON de interface do ComfyUI 0.4, 15 nós integrados, três ramificações de luz, um manifesto exato do modelo e das fontes de software, um validador offline e uma folha de comparação em branco.

**O que foi verificado:** sintaxe JSON, esquema oficial UI 0.4, estrutura dos nós, tipos de conexões, grafo sem ciclo, parâmetros concordantes e padrões introduzidos de propósito. **O ComfyUI não foi iniciado; nenhuma imagem foi gerada, nenhuma necessidade de VRAM nem tempo de geração foi medido.** A importação em uma interface ComfyUI e a execução no seu ambiente ainda precisam ser verificadas. O pacote não contém nenhum peso.

## 1. Verificar o pacote sem o ComfyUI

Descompacte o arquivo e abra um terminal em `comfyui-v1`. Com Python 3.10 ou mais recente:

```console
python validate_workflow.py
```

O validador usa apenas a biblioteca padrão, não contata nenhum servidor e não executa nenhum cálculo de IA. O resultado esperado para o pacote intacto contém `ok: true`, `nodes: 15`, `links: 25`, `checkpoint_verified: false`, `comfyui_executed: false` e `image_generated: false`. Uma falha retorna um código de saída 1 e uma explicação. Esse validador verifica o perfil específico deste pacote, não qualquer workflow ComfyUI possível.

## 2. Reunir as dependências na máquina de destino

O grafo foi construído a partir das definições do **ComfyUI 0.37.0**, commit `73c9bad4d21e7addbe1d13bc92eee0f1431b017d`. As dependências dessa versão apontam para **comfyui-frontend-package 1.52.7**, commit do frontend `1a7a6b82514874545dc5e8203d0bd2188c2d9b18`. São referências documentais exatas, não um ambiente instalado e executado nesta entrega. Uma versão mais recente pode importar o formato; essa possibilidade não equivale a validar seu comportamento.

Use a [instalação oficial adequada ao seu sistema](https://docs.comfy.org/installation/manual_install). Não substitua às cegas sua instalação de produção. Registre as versões realmente usadas em `environnement-a-remplir.json`, em particular Python, PyTorch, o driver, a precisão e as opções de inicialização. Nenhum Python/PyTorch de geração é apresentado como testado aqui.

O único modelo necessário é o **Stable Diffusion XL Base 1.0** da Stability AI:

- repositório: `stabilityai/stable-diffusion-xl-base-1.0`;
- revisão: `462165984030d82259a11f4367a4eed129e94a7b`;
- arquivo: `sd_xl_base_1.0.safetensors`;
- tamanho de referência: `6938078334` bytes, sem relação direta com o pico de VRAM;
- SHA-256 de referência: `31e35c80fc4829d14f90153f4c74cd59c90b779f6afe05a74cd6120b893f7e5b`;
- local previsto: `ComfyUI/models/checkpoints/sd_xl_base_1.0.safetensors`.

Consulte o [arquivo do editor na revisão fixada](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/sd_xl_base_1.0.safetensors) e sua [licença CreativeML Open RAIL++-M](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/LICENSE.md) antes de obtê-lo separadamente. O pacote não realiza nenhum download. A impressão digital vem dos metadados LFS do editor; ela não foi recalculada sobre os pesos nesta entrega.

Para comparar o arquivo que você já possui, sem carregá-lo na memória da GPU:

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

Essa opção lê o arquivo para verificar seu tamanho e sua impressão digital. Ela pode levar tempo dependendo do armazenamento. Uma impressão digital correta não é prova de execução bem-sucedida. Nenhum refiner, LoRA, ControlNet, imagem de entrada ou nó personalizado é exigido por este grafo.

## 3. Importar e ler as três ramificações

Abra uma instalação ComfyUI preparada e importe `workflow-ui.json` na interface, abrindo o workflow ou arrastando e soltando o JSON sobre a tela. **Não envie esse arquivo ao endpoint de API `/prompt`: ele descreve a interface, não o payload de execução da API.**

Vérifiez le choix du checkpoint dans le nœud 1. Si le fichier a été placé dans un sous-dossier, sélectionnez son chemin réel et conservez cette modification dans votre copie du manifeste. Si le menu ne le propose pas, contrôlez d’abord son emplacement et les chemins supplémentaires de votre installation, puis actualisez les modèles ou redémarrez suivant la procédure de votre version.

Les branches A, B et C reprennent le même objet fictif : un vase ivoire mat sur un socle bleu cobalt, avec une zone libre prévue pour un titre ajouté ensuite dans un logiciel de mise en page. Les prompts sont en anglais pour cet exemple SDXL ; le dossier explique leur rôle en français. Seule la dernière phrase du prompt positif varie : frontale douce, latérale gauche, contre-jour.

Les trois KSampler utilisent `24092026`, contrôle après génération `fixed`, 24 pas, CFG 6.5, `euler`, `normal`, denoise 1. Le latent commun est de 1024 × 1024 pixels avec un lot de 1. Ces nombres définissent l’exercice ; ils ne sont ni un réglage optimal universel ni une mesure de performance. La recette ne pilote pas trois GPU et n’assemble pas un triptyque en une seule image.

## 4. Exécuter et juger votre résultat

Lancez une exécution lorsque les dépendances sont disponibles. Chaque branche doit atteindre son nœud SaveImage. Les préfixes sont `RenderParcel/ceramique-v1/a_frontale`, `b_laterale` et `c_contrejour` dans le répertoire de sortie de ComfyUI ; ComfyUI ajoute ses compteurs de fichiers. Trois branches ne garantissent pas une exécution simultanée.

Ouvrez les trois PNG. Remplissez `comparaison.csv` : bord lisible, matière lisible, place pour le titre, déformation, variante retenue et commentaire. Les cellules sont volontairement vides. La lumière peut aussi changer la silhouette ou la composition : un seed commun ne verrouille pas un objet réel. Pour une représentation fidèle d’un produit, ce dossier text-to-image est seulement une étude de direction, pas un procédé de reproduction contrôlée.

La validation sur votre machine est terminée lorsque les fichiers existent, s’ouvrent, ont les dimensions prévues et répondent à vos critères. Relevez l’environnement, exportez le JSON utilisé et gardez une image témoin produite par votre exécution. N’inventez pas une durée ou une VRAM si vous ne l’avez pas mesurée.

## 5. Reconstruire, modifier, transmettre

`reconstruction.md` détaille chaque connexion et l’ordre des widgets. Pour modifier le cas, dupliquez le dossier, changez une variable à la fois et mettez à jour le manifeste. Le validateur du profil v1 peut refuser une extension volontaire : cela ne prouve pas qu’elle est invalide pour ComfyUI, seulement qu’elle sort du dossier contrôlé.

Conservez le JSON indépendamment des PNG. Les métadonnées incorporées peuvent être retirées par une conversion ou un partage. Archivez aussi votre manifeste complété, la comparaison et les sorties sélectionnées. Les bibliothèques, poids et pilotes restent des dépendances distinctes.

## Sources techniques

- [Format UI ComfyUI 0.4](https://docs.comfy.org/specs/workflow_json_0.4).
- [Nœuds intégrés, source ComfyUI 0.37.0](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/nodes.py).
- [Dépendances de cette version](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/requirements.txt).
- [Emplacement des modèles](https://docs.comfy.org/basic-concepts/models).
- [SDXL dans ComfyUI, exemples de l’auteur](https://comfyanonymous.github.io/ComfyUI_examples/sdxl/).
- [Limites de reproductibilité PyTorch](https://docs.pytorch.org/docs/2.14/notes/randomness.html).

Les ressources originales du dossier relèvent de `LICENSE.md`. Les logiciels et le modèle gardent leurs licences propres. Aucun fichier de compte, paiement, identité, cookie ou secret n’est nécessaire à ce projet.

## Compatibilité des sorties v1

Les nouvelles images utilisent le préfixe `RenderParcel/ceramique-v1/`. Aucun dossier de sortie déjà présent n'est déplacé ou supprimé. Les identifiants des quinze nœuds, les liens et les réglages restent identiques.

Le validateur accepte aussi le préfixe historique `Prismora/ceramique-v1/`, avec les mêmes noms de variantes. Il peut ainsi lire un workflow v1 antérieur avec le manifeste actuel ; il n'accepte pas un nom de variante différent. Les images déjà produites conservent leur chemin d'origine.