> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gizmo.antimlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Idea

> How Gizmo transforms text prompts into simulation-ready 3D scenes

```
text prompt + optional reference image
            |
            v
AI agent pipeline (plan → generate → assemble → validate)
            |
            v
parametric primitives, materials, modifiers, joints, physics
            |
            v
scene saved to your Gizmo library (single source of truth)
            |
            |---> USD / USDZ for Isaac Sim
            |---> MJCF package for MuJoCo
            |---> SDF world for Gazebo
            '---> GLB for visual mesh interchange
```

Every scene you generate is saved to your Gizmo library and serves as a single source of truth. From the same scene, you can export to USD, USDZ, MJCF, SDF, or GLB and run the same simulation across different backends — no re-authoring, no separate per-simulator copies to maintain.

## Generation Pipeline

When you submit a prompt, the AI agent runs through these stages:

1. **Asset Planning** — identifies what objects are needed, plans their structure
2. **Concept Images** — generates reference visuals to guide geometry creation
3. **Asset Generation** — builds each asset in parallel (geometry, joints, materials, physics)
4. **Floorplan** — creates the room layout and spatial constraints
5. **Constraint Solving** — places assets using deterministic spatial reasoning (no overlap, clearance rules)
6. **Structure** — builds walls, floors, ceilings, doors, and windows
7. **Lighting** — adds appropriate light sources
8. **Validation** — runs physics checks, connectivity verification, and robotics-readiness tests

## Geometry Pipelines

Gizmo uses two geometry approaches:

| Pipeline                 | Best For                                                 | Output                                                                               |
| ------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| **Parametric (default)** | Furniture, environments, general assets                  | Editable primitives with modifiers (bend, taper, twist, chamfer, shell, bulge, etc.) |
| **Precision CAD**        | Mechanical parts, robotic components, engineering assets | B-Rep solids generated via build123d for exact geometric tolerances                  |

The `auto` mode selects the best pipeline for each asset based on the prompt. You can also request a specific pipeline via the `asset_pipeline` parameter on `POST /v1/scenes` and `POST /v1/assets` (`auto`, `gizmo`, or `cad`).

## Reference Images

You can attach one or more reference images alongside your text prompt. The agent uses them to:

* Count and identify components
* Match proportions and spatial arrangement
* Guide material and color choices
* Verify output against the reference during review stages