Eve library

ISIS v2 NPC Crowd Variation Pack Image-Conditioned Workflow Graph

Guide

Revision 1

On this page

Generated: 2026-08-02T17:39:31.243Z Checklist: MXA-0093 (ISIS2-00291) Asset Family: npc-crowd-variation-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define an image-conditioned npc-crowd-variation-pack workflow graph that applies style/composition reference images through IPAdapter while preserving deterministic generation defaults for crowd-lineup production.

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
adapterModel ip-adapter_sdxl.safetensors
seed 2026090203
width 1920
height 1080
steps 32
cfgScale 6.2
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
referenceStrength 0.72
compositionStrength 0.58
batchSize 1
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
style_reference_image image yes n/a
composition_reference_image image no n/a
use_composition_reference boolean yes false
reference_strength float yes 0.72
composition_strength float yes 0.58
character_archetype enum yes hero
style_preset enum yes stylized
crowd_role_profile enum yes civilians-mixed
crowd_activity_profile enum yes market-flow
crowd_layout_pattern enum yes staggered-depth-lanes
wardrobe_variation_profile enum yes neutral-market-tones
environment_context enum yes market-square
camera_framing enum yes wide-crowd
seed integer yes 2026090203
width integer yes 1920
height integer yes 1080
steps integer yes 32
cfg_scale float yes 6.2

Graph Nodes#

Node ID Class Role Output Count
n1 LoadImage style-reference-load 2
n2 LoadImage composition-reference-load 2
n3 CheckpointLoaderSimple model-load 3
n4 IPAdapterLoader adapter-load 1
n5 IPAdapterApply style-condition 1
n6 IPAdapterApply composition-condition 1
n7 CLIPTextEncode positive-conditioning 1
n8 CLIPTextEncode negative-conditioning 1
n9 EmptyLatentImage latent-init 1
n10 KSampler latent-sample 1
n11 VAEDecode image-decode 1
n12 SaveImage artifact-output 0

Graph Edges#

Edge ID From To
e1 n3:0 n5.model
e2 n4:0 n5.ipadapter
e3 n1:0 n5.image
e4 n5:0 n6.model
e5 n4:0 n6.ipadapter
e6 n2:0 n6.image
e7 n3:1 n7.clip
e8 n3:1 n8.clip
e9 n6:0 n10.model
e10 n7:0 n10.positive
e11 n8:0 n10.negative
e12 n9:0 n10.latent_image
e13 n10:0 n11.samples
e14 n3:2 n11.vae
e15 n11:0 n12.images

Topological Node Order#

n1 -> n2 -> n3 -> n4 -> n5 -> n6 -> n7 -> n8 -> n9 -> n10 -> n11 -> n12

Research Alignment#

Workflow Path LoadImage Nodes IPAdapter Nodes
Consistent Character Generator libs/isis/workflows/src/workflows/avatar/consistent-character.json 1 1
AI Style Transfer libs/isis/workflows/src/workflows/utility/style-transfer.json 2 0
Stable Zero123 Multi-View Generator libs/isis/workflows/src/workflows/3d/stable-zero123.json 1 0

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • Image conditioning path is explicit and includes style + optional composition references.
  • All deterministic defaults are explicitly set (seed, sampler, scheduler, checkpoint, adapter).
  • Output contract aligns to MXA-0091 required output classes.

Traceability#

  • Checklist item: MXA-0093
  • Ticket key: ISIS2-00291
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_BASELINE_WORKFLOW_GRAPH.json
    • libs/isis/workflows/src/workflows/avatar/consistent-character.json
    • libs/isis/workflows/src/workflows/utility/style-transfer.json
    • libs/isis/workflows/src/workflows/3d/stable-zero123.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json
    • docs/domains/isis/remediation-v2/ISIS_V2_WORKFLOW_AUTHORING_GUIDE.json
    • ISIS_TODOS_2.md