| name | background-creator |
| description | Generate background 3D scenes with EmbodiedGen using scene3d-cli. Use this skill whenever users ask to create room/indoor background scenes from text prompts, pre-generate backgrounds for layout-cli, or control scene3d generation quality/runtime with retry, seed, and gs3d settings. |
Background Creator
Unified entry for EmbodiedGen background scene generation via scene3d-cli.
When To Use
Use this skill when users want to:
- Generate indoor/background 3D scenes from text prompts.
- Pre-generate scene assets for
layout-cli.
- Control
scene3d-cli runtime/quality via seed, retry, and gs3d settings.
Routing Rule (Core)
Use scene3d-cli when input is scene-level text prompts and output target is a background scene (mesh + 3DGS), not single foreground assets.
Pre-checks
- Run commands from the repository root.
- Confirm the active environment is
embodiedgen.
- Install scene3d dependencies first if needed:
bash install.sh scene3d
- If CLI commands are unavailable, run
pip install -e . to register entrypoints.
Standard Command Template
scene3d-cli --prompts "Art studio with easel and canvas" \
--output_dir outputs/bg_scenes \
--seed 0 \
--gs3d.max_steps 4000 \
--disable_pano_check
Common Parameters
--prompts: one or more scene text prompts.
--output_dir: output root directory for generated scenes.
--seed: random seed for reproducibility.
--n_retry: panorama generation retries.
--real_height: force target real-world room height in meters.
--pano_image_only: generate only panorama image (debug/fast validation).
--disable_pano_check: skip panorama quality check.
--keep_middle_result: keep intermediate training artifacts.
--gs3d.max_steps: training steps for 3DGS optimization.
Output Conventions
Each prompt is saved under <output_dir>/scene_xxxx/, typically including:
gs_model.ply
mesh_model.ply
pano_image.png
prompt.txt
video.mp4
gsplat_cfg.yml
Runtime Expectations
- Typical full generation time is around 30 minutes per scene.
- Use
--pano_image_only for quick prompt validation before full generation.
Failure Handling and Retry
- OOM or GPU pressure: reduce concurrency and lower
--gs3d.max_steps.
- Unstable scene quality: increase
--n_retry or adjust prompt specificity.
- Missing outputs: verify
--output_dir permissions and use absolute paths.