# Room Creator

> Room Creator is an Agent Skill for design published in the HorizonRobotics/EmbodiedGen repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generate indoor rooms (single room or house) and export URDF/USD by wrapping embodied_gen/scripts/room_gen/gen_room.py. Use when users ask to create rooms with seed control, choose room type and complexity, run generation/export stages, or run reproducible room generation jobs (batch runs can be done by wrapping this command in an outer loop/script).

- Skill name: `room-creator`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/HorizonRobotics/EmbodiedGen/blob/HEAD/embodied_gen/skills/room-creator/SKILL.md
- Repository: HorizonRobotics/EmbodiedGen (529 GitHub stars when collected)

## SKILL.md

# Room Creator

Generate room scenes with `room-cli -m embodied_gen.scripts.room_gen.gen_room` from infinigen(https://github.com/princeton-vl/infinigen) and optionally export URDF/USD. `room-cli` forwards its arguments to the bundled Blender Python (has `bpy` and room deps installed by `bash install.sh room`); running `python -m embodied_gen.scripts.room_gen.gen_room` from the `embodiedgen` env works too since heavy stages dispatch to Blender Python internally either way.

## Use This Workflow

1. Confirm output root and target room profile.
2. Choose generation scope:
- `--gen --urdf --usd` for full pipeline.
- `--gen --no-urdf --no-usd` for generation only.
- `--no-gen --urdf --usd` for export from existing blender output.
3. Run the command from repository root.
4. Verify output folder: `<output_root>/<RoomType>_seed<seed>/` (if `--seed` is omitted, check the generated seed from logs first).

## Parameters

- `--output-root` (required): base output directory.
- `--prompt`: natural-language task/scene description; a GPT router infers room type and complexity from it, overriding `--room-type`/`--complexity`. Requires a configured GPT agent.
- `--room-type`: `Bedroom | LivingRoom | Kitchen | Bathroom | DiningRoom | Office | House`.
- `--seed`: random seed. For reproducible runs, pass this explicitly; if omitted, a random seed is generated.
- `--complexity`: `minimalist | simple | medium | detail`.
- `--custom-params`: gin file copied to Infinigen `custom_solve.gin`.
- `--large-scene`: only for `House`; enables more rooms.
- `--gen/--no-gen`, `--urdf/--no-urdf`, `--usd/--no-usd`: pipeline switches.

## Complexity Guidance

- `minimalist`: fastest, sparse furniture.
- `simple`: default, balanced quality/time.
- `medium`: richer layout, slower.
- `detail`: highest detail, longest runtime.

## Command Templates

```bash
# Full pipeline for one kitchen
room-cli -m embodied_gen.scripts.room_gen.gen_room \
  --output-root outputs/rooms \
  --room-type Kitchen \
  --seed 42 \
  --complexity simple
```

```bash
# Generation only (no export)
room-cli -m embodied_gen.scripts.room_gen.gen_room \
  --output-root outputs/rooms \
  --room-type LivingRoom \
  --seed 100 \
  --complexity medium \
  --no-urdf --no-usd
```

```bash
# Export only from existing blender result
room-cli -m embodied_gen.scripts.room_gen.gen_room \
  --output-root outputs/rooms \
  --room-type Kitchen \
  --seed 42 \
  --no-gen --urdf --usd
```

```bash
# House generation (use --large-scene for more rooms)
room-cli -m embodied_gen.scripts.room_gen.gen_room \
  --output-root outputs/rooms \
  --room-type House \
  --seed 7 \
  --complexity simple \
  --large-scene
```

## Runtime Requirements

- Run from repo root so relative paths resolve.
- `room-cli` resolves Blender Python from `$BLENDER_PYTHON_BIN` if set, else falls back to
  `thirdparty/infinigen/blender/4.2/python/bin/python3.11` (must exist on disk).
- `--no-gen` requires existing blender output at:
  `<output_root>/<RoomType>_seed<seed>/blender`.

---

Source: https://www.openparable.com/skill/design/room-creator (OpenParable). Cite the canonical URL above.
