Asset Creator

Assets Creator

Unified entry for three EmbodiedGen asset-generation CLIs: img3d-cli, text3d-cli, and texture-cli.

When To Use

Use this skill when users want to:

• Generate a 3D asset from one or more input images.
• Generate 3D assets in batch from text prompts.
• Generate or edit textures for existing meshes.
• Get help choosing the correct CLI from mixed asset-generation requirements.

Routing Rules (Core)

1. img3d-cli: input is image paths (--image_path or --image_root).
2. text3d-cli: input is text prompts (--prompts) and target is direct asset output.
3. texture-cli: input is existing mesh path(s) (--mesh_path) plus texture prompt(s) (--prompt).

Pre-checks

1. Run commands from the repository root.
2. Confirm the active environment is embodiedgen.
3. If CLI commands are unavailable, run pip install -e . to register entrypoints.

Standard Command Templates

1) Image to 3D: img3d-cli

img3d-cli --image_path .../sample.jpg --n_retry 1 --output_root outputs/imageto3d

Common parameters:

• --image_path / --image_root
• --output_root
• --n_retry
• --seed
• --skip_exists

2) Text to 3D: text3d-cli

text3d-cli \
  --prompts "small bronze figurine of a lion" "A globe with wooden base" \
  --n_image_retry 1 --n_asset_retry 1 --n_pipe_retry 1 \
  --seed_img 0 \
  --output_root outputs/textto3d

Common parameters:

• --prompts
• --output_root
• --asset_names
• --n_image_retry --n_asset_retry --n_pipe_retry
• --seed_img --seed_3d

3) Mesh Texture Generation: texture-cli

texture-cli \
  --mesh_path ".../horse.obj" \
  --prompt "A gray horse head with flying mane and brown eyes" \
  --output_root "outputs/texture_gen" \
  --seed 0

Common parameters:

• --mesh_path (supports multiple inputs)
• --prompt (must align 1:1 with mesh inputs)
• --output_root
• --seed
• --texture_size
• --ip_adapt_scale --ip_img_path (optional reference-image control)

Output Conventions

• img3d-cli: each sample is typically under <output_root>/<sample>/result/.
• text3d-cli: <output_root>/asset3d/<asset_name>/result/.
• texture-cli: <output_root>/<mesh_stem>/texture_mesh/.

Failure Handling and Retry

1. OOM or GPU pressure: reduce batch size and concurrency.
2. Unstable quality: increase --n_retry or --n_*_retry.
3. Missing outputs: verify output-root permissions and path spelling; prefer absolute paths.