env serve
Serve reset/step/observe episodes over a local socket or named pipesimforge env serve [OPTIONS] --socket <PATH> <WORKSPACE>
| Argument / flag | Notes | What |
|---|---|---|
<workspace> | required | The scenario package or workspace directory (a package without a simulation is compiled from its document and recordings) |
--socket PATH | required | Local endpoint path; Windows derives a same-user named pipe from this path |
--rig RIG.JSON | The sensor rig (simforge.render-rig/v1, as simforge render takes it) | |
--no-sensors | Serve the episode without a renderer (observations are the engine’s only) | |
--observation-profile OBSERVATION_PROFILE | one of state, sensors, both | Restrict observations to state, sensors, or both; omission preserves the native layout |
--preset PRESET | one of training, showcase; default training | The render preset for observations (schematic is offline simforge render only) |
--set KEY=VALUE | repeatable | Renderer overrides, including textureMaxSize=1024|2048|4096|full |
--passes PASSES | one of rgb, hdr, id, depth, semantic; default rgb; repeatable | Camera passes rendered per observation, comma-separated |
--textures TEXTURES | one of uastc-full, bc7-512; default uastc-full | The staged texture tier |
--episode EPISODE.JSON | Episode configuration (camelCase EpisodeConfig, as the gym’s episode specs carry it) | |
--decision-hz HZ | Policy decisions per second (overrides the episode’s decisionHz) | |
--max-objects N | default 64 | Rows of the objects observation |
--allow-software-adapter | Render on a software (CPU) Vulkan adapter such as lavapipe, explicitly | |
--map-dir DIR | Use this map directory instead of the installed map found by content | |
--cache-root DIR | Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps | |
--assets-root DIR | Actor-asset root. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets | |
--actor-closure SHA256 | The actor closure to bind, instead of the workspace’s catalog.actorClosureDigest | |
--actor-layer SHA256 | The workspace’s private model layer (an actor closure in the same store) for workspace.* models, instead of the workspace’s simforge.actorLayer extension | |
--vram-budget BYTES | A texture budget in bytes; without it admission is skipped (reported) | |
--log FILE | Where the renderer’s diagnostics go. Default: <socket>.log | |
--allow-map-drift | Render on the installed map release even where its members differ from the workspace’s map closure (recorded; the default refuses) | |
--max-sessions N | default 8 | Maximum concurrent client sessions sharing one prewarmed renderer. Training defaults to eight sessions per map renderer |
--shm-size-mb MIB | default 512 | Size of the renderer’s shared-memory frame ring, MiB |