⚙️ Pipeline¶
Batch job management, format conversion and engine export, prefab integration helpers, and workflow chaining.
Quick Reference¶
| Command | Description | Model |
|---|---|---|
assgen gen pipeline workflow create |
Define a new multi-step workflow (sequence of job types) | — |
assgen gen pipeline workflow run |
Execute a saved workflow, chaining each step's output into the next | — |
assgen gen pipeline workflow list |
List all saved workflows | — |
assgen gen pipeline batch queue |
Enqueue a batch of jobs from a JSON manifest file | — |
assgen gen pipeline batch variant |
Generate style or damage-state variants of an existing asset | — |
assgen gen pipeline batch status |
Show recent batch / queue status (active + recently completed jobs) | — |
assgen gen pipeline integrate export |
Export an asset to a specific game engine format | (algorithmic) |
assgen gen pipeline integrate prefab |
Bundle multiple assets into an engine prefab or scene package | — |
assgen gen pipeline integrate script |
Generate behavior script stubs and attach-point metadata for a mesh | — |
assgen gen pipeline asset manifest |
Walk a directory and produce a manifest.json with file metadata | (algorithmic) |
assgen gen pipeline asset validate |
Check for oversized textures, non-pow2 textures, and high-poly meshes | (algorithmic) |
assgen gen pipeline asset rename |
Batch rename assets to a naming convention (dry-run by default) | (algorithmic) |
assgen gen pipeline asset report |
Generate a size-budget report grouped by asset type | (algorithmic) |
assgen gen pipeline git lfs-rules |
Scan asset extensions and generate .gitattributes LFS rules | — |
assgen gen pipeline workflow create¶
Define a new multi-step workflow (sequence of job types).
By default, each step's output is automatically chained into the next step as upstream_files. Use --no-chain to submit all steps independently.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
NAME (required) |
TEXT |
— |
Workflow name |
STEPS (required) |
TEXT |
— |
Ordered job types, e.g. visual.concept.generate visual.model.splat |
--output |
TEXT |
— |
Save workflow YAML to path |
--chain |
BOOLEAN |
True |
Auto-chain each step's output into the next step's upstream_files (default: on) |
assgen gen pipeline workflow run¶
Execute a saved workflow, chaining each step's output into the next.
Unlike a simple batch submit, each step waits for the previous to complete and receives its output files as upstream_files — enabling real multi-step pipelines where later steps depend on earlier outputs.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
NAME (required) |
TEXT |
— |
Workflow name or path to YAML |
--inputs |
TEXT |
— |
JSON string of input params |
--dry-run |
BOOLEAN |
False |
Print steps without executing |
assgen gen pipeline workflow list¶
List all saved workflows.
assgen gen pipeline batch queue¶
Enqueue a batch of jobs from a JSON manifest file.
Manifest format: [{"job_type": "visual.model.create", "params": {"prompt": "..."}, "priority": 0}, ...]
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
MANIFEST (required) |
TEXT |
— |
Path to JSON manifest file |
--wait |
BOOLEAN |
— |
assgen gen pipeline batch variant¶
Generate style or damage-state variants of an existing asset.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
INPUT_ASSET (required) |
TEXT |
— |
Base asset path |
--variants |
INTEGER |
4 |
Number of variants |
--style |
TEXT |
— |
Style description for variants |
--damage |
BOOLEAN |
False |
Generate damage-state variants |
--wait |
BOOLEAN |
— |
assgen gen pipeline batch status¶
Show recent batch / queue status (active + recently completed jobs).
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
--limit |
INTEGER |
20 |
assgen gen pipeline integrate export¶
Export an asset to a specific game engine format.
Algorithmic — no AI model required
This command uses CPU-based algorithms. No model download or GPU required.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
INPUT_ASSET (required) |
TEXT |
— |
Asset to export |
--engine |
TEXT |
unity |
unity | unreal | godot |
--format |
TEXT |
— |
Override output format |
--wait |
BOOLEAN |
— |
assgen gen pipeline integrate prefab¶
Bundle multiple assets into an engine prefab or scene package.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
ASSETS (required) |
TEXT |
— |
Asset files to bundle into a prefab |
--name |
TEXT |
— |
Prefab name |
--engine |
TEXT |
unity |
|
--wait |
BOOLEAN |
— |
assgen gen pipeline integrate script¶
Generate behavior script stubs and attach-point metadata for a mesh.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
MESH (required) |
TEXT |
— |
Mesh to generate behavior stubs for |
--behaviors |
TEXT |
interact,damage,loot |
Comma-separated behavior types to stub |
--language |
TEXT |
csharp |
csharp | gdscript | blueprint |
--wait |
BOOLEAN |
— |
assgen gen pipeline asset manifest¶
Walk a directory and produce a manifest.json with file metadata.
Algorithmic — no AI model required
This command uses CPU-based algorithms. No model download or GPU required.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
DIRECTORY (required) |
TEXT |
— |
Directory to scan |
--wait |
BOOLEAN |
— |
assgen gen pipeline asset validate¶
Check for oversized textures, non-pow2 textures, and high-poly meshes.
Algorithmic — no AI model required
This command uses CPU-based algorithms. No model download or GPU required.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
DIRECTORY (required) |
TEXT |
— |
Directory to validate |
--max-texture-mb |
FLOAT |
16.0 |
Max texture file size in MB |
--max-mesh-verts |
INTEGER |
100000 |
Max vertex count per mesh |
--wait |
BOOLEAN |
— |
assgen gen pipeline asset rename¶
Batch rename assets to a naming convention (dry-run by default).
Algorithmic — no AI model required
This command uses CPU-based algorithms. No model download or GPU required.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
DIRECTORY (required) |
TEXT |
— |
Directory containing files to rename |
--convention |
TEXT |
snake_case |
snake_case | PascalCase | kebab-case |
--prefix |
TEXT |
— |
Optional name prefix |
--suffix |
TEXT |
— |
Optional name suffix |
--dry-run |
BOOLEAN |
True |
Plan only (default) or execute renames |
--wait |
BOOLEAN |
— |
assgen gen pipeline asset report¶
Generate a size-budget report grouped by asset type.
Algorithmic — no AI model required
This command uses CPU-based algorithms. No model download or GPU required.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
DIRECTORY (required) |
TEXT |
— |
Directory to report on |
--wait |
BOOLEAN |
— |
assgen gen pipeline git lfs-rules¶
Scan asset extensions and generate .gitattributes LFS rules.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
DIRECTORY (required) |
TEXT |
— |
Directory to scan for asset types |
--wait |
BOOLEAN |
— |