| name | asset-creator |
| description | Create 3D assets with EmbodiedGen using img3d-cli, text3d-cli, and texture-cli. Use this skill whenever users ask to generate assets from images/text, texture existing meshes, run retry/seed controlled generation, or choose the proper asset-generation CLI from mixed requirements. |
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)
img3d-cli: input is image paths (--image_path or --image_root).text3d-cli: input is text prompts (--prompts) and target is direct asset output.texture-cli: input is existing mesh path(s) (--mesh_path) plus texture prompt(s) (--prompt).
Pre-checks
- Run commands from the repository root.
- Confirm the active environment is
embodiedgen.
- 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
- OOM or GPU pressure: reduce batch size and concurrency.
- Unstable quality: increase
--n_retry or --n_*_retry.
- Missing outputs: verify output-root permissions and path spelling; prefer absolute paths.
