simready-forge 0.1.0__tar.gz

simready_forge-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Assets the kit writes when run from a clone (examples, live tests)
+simready_assets/
+
+# Test results
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Claude Code local state: machine-specific settings and keys.
+.claude/settings.local.json
+.claude/worktrees/
+CLAUDE.local.md
+
+# Scratch files the skills write: review packs, issue and PR bodies.
+.local/

simready_forge-0.1.0/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+What changed for people who use simready-forge, newest first. A change users notice adds its line under Unreleased in
+the same PR; the release PR renames Unreleased to `## X.Y.Z (YYYY-MM-DD)`, which the gate's version check reads. The
+format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## 0.1.0 (2026-10-29)
+
+The first version.
+
+### Added
+
+- **`/simready-forge:make`** turns a prompt or a photo into an NVIDIA SimReady asset: OpenUSD on the Robotics-Prop
+  4.0.0 profile with real dimensions, materials, physics materials, rigid bodies, colliders, mass and the joints the
+  real object has, checked by NVIDIA's validator, its joints measured in Isaac Sim, exported as URDF and GLB, with a
+  report of what it cost. Three modes: Quick (the builder alone), Standard (the default: the builder, then critics
+  until clean, 4 rounds at most) and Max (two or three builders and a blind judge, then critics and a refuter).
+- **`/simready-forge:settings`** shows and changes the choices it remembers, such as the builder's and the critics'
+  models and effort, for a session, a project or always.
+- **`/simready-forge:review`** validates and reviews an asset you already have, with critics.
+- **The agents** `builder` (writes and runs the build script), `critic` (fresh eyes on the renders, the spec and the
+  measurements), `refuter` (checks the builder's report against the files) and `judge` (picks between candidates
+  blind, in Max mode).
+- **The physics probe** (`simready-forge probe`): tilt, a hand's push on each part, lift and shake, 10 s at rest and
+  a box dropped on top, each measured against what the asset's own values predict.
+- **`simready-forge poses`** checks the review's joint poses without Isaac Sim (overlaps, the ground, near misses,
+  openings that must stay empty), and **`simready-forge inspect`** reads a USD back for a refuter.
+- **The `simready-forge` package and command line:** `validate`, `review`, `probe`, `poses`, `inspect`, `trellis`,
+  `views`, `qcode`, `prefs`, `cost` and `example`, and the kit's `Asset` for build scripts written by hand. Each asset is written as
+  `<name>/usd/<name>.usda`, with `<name>_exports/` and `<name>_reports/` beside it.

simready_forge-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Soma Osvay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

simready_forge-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.5
+Name: simready-forge
+Version: 0.1.0
+Summary: Turn a prompt or a photo into an NVIDIA SimReady asset: OpenUSD with materials, physics and joints
+Project-URL: Homepage, https://github.com/serionist/simready-forge
+Project-URL: Repository, https://github.com/serionist/simready-forge
+Project-URL: Documentation, https://github.com/serionist/simready-forge/tree/main/docs
+Project-URL: Issues, https://github.com/serionist/simready-forge/issues
+Author: Soma Osvay
+License-Expression: MIT
+License-File: LICENSE
+Keywords: build123d,claude-code,isaac-sim,omniverse,openusd,robotics,simready,simulation,usd
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: <3.14,>=3.12
+Requires-Dist: build123d==0.13.0
+Requires-Dist: coacd==1.0.14
+Requires-Dist: matplotlib==3.11.2
+Requires-Dist: numpy==2.5.4
+Requires-Dist: physx-usd-schemas==25.11.2.72696984
+Requires-Dist: pillow==13.0.0
+Requires-Dist: scipy==1.18.1
+Requires-Dist: simready-foundation-tier-core==2026.8.0
+Requires-Dist: simready-validate==2026.8.0
+Requires-Dist: trimesh==5.2.0
+Requires-Dist: usd-core==26.11
+Requires-Dist: usd-profiles-nvidia==1.22.0
+Requires-Dist: usd-validation-nvidia==1.22.0
+Description-Content-Type: text/markdown
+
+<h1 align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/logo-dark.svg">
+    <img src="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/logo.svg" alt="simready-forge" width="520">
+  </picture>
+</h1>
+
+<p align="center"><b>Type what you want, or attach a photo. Get an NVIDIA SimReady asset that simulates.</b></p>
+
+<p align="center">
+  <a href="https://github.com/serionist/simready-forge/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/serionist/simready-forge/actions/workflows/ci.yml/badge.svg?branch=main"></a>
+  <a href="https://github.com/serionist/simready-forge/actions/workflows/codeql.yml"><img alt="CodeQL" src="https://github.com/serionist/simready-forge/actions/workflows/codeql.yml/badge.svg?branch=main"></a>
+  <a href="https://github.com/serionist/simready-forge/blob/main/LICENSE"><img alt="Licence: MIT" src="https://img.shields.io/badge/licence-MIT-007ec6"></a>
+  <a href="https://www.python.org/"><img alt="Python 3.12 | 3.13" src="https://img.shields.io/badge/python-3.12%20%7C%203.13-3776ab?logo=python&logoColor=white"></a>
+  <a href="https://docs.anthropic.com/en/docs/claude-code"><img alt="Claude Code plugin" src="https://img.shields.io/badge/Claude%20Code-plugin-d97757"></a>
+  <a href="#how-an-asset-is-checked"><img alt="SimReady: Robotics-Prop 4.0.0" src="https://img.shields.io/badge/SimReady-Robotics--Prop%204.0.0-1f7a8c"></a>
+  <a href="https://openusd.org/"><img alt="OpenUSD" src="https://img.shields.io/badge/OpenUSD-26.11-4a4a4a"></a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/showcase.jpg" alt="Eight assets made by simready-forge: a desk lamp, a rangefinder camera, a bottle, a nightstand, a running shoe, a pipe pile, a cable drum and a barricade" width="100%">
+  <br><sub>Eight assets made in Max mode, rendered in Isaac Sim by the review that checks them.</sub>
+</p>
+
+```text
+/simready-forge:make a 180 mm desk lamp with an adjustable arm, a weighted base and a translucent shade
+```
+
+A Claude Code plugin and a Python kit. One prompt or photo in; out comes:
+
+- **OpenUSD** (NVIDIA SimReady, Robotics-Prop 4.0.0) with real dimensions, materials and physics
+- **Every joint the real object has**, driven and measured in Isaac Sim
+- **URDF and GLB** exports, a report, and the build script to tweak and rerun
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/joints.webp" alt="A desk lamp, a camera, a nightstand and a barricade, at rest and with every joint driven" width="80%">
+  <br><sub>At rest, then every joint driven: the review watches each mechanism move.</sub>
+</p>
+
+## How it works
+
+```mermaid
+flowchart LR
+    R["Prompt or photo"] --> S["Spec<br/>parts, joints,<br/>materials"]
+    S --> B["Builder<br/>build123d + kit,<br/>or TRELLIS.2"]
+    B --> V["NVIDIA validator"]
+    V --> I["Isaac Sim review<br/>every joint driven"]
+    I --> C["Critics + refuter"]
+    C -- "findings" --> B
+    C -- "clean" --> P["Package + report"]
+```
+
+| Mode | What runs |
+|---|---|
+| **Quick** | one builder, one fix round at most |
+| **Standard** | one builder, then critics and a refuter until clean (≤ 4 rounds) |
+| **Max** | three builders, a blind judge picks one, then Standard on it |
+
+Asked once, remembered per session, project or always. Override per run: `mode=max`, `builder=opus`, `effort=high`.
+
+## How an asset is checked
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/review-sheet.jpg" alt="The Isaac review's contact sheet for a desk lamp: views at rest and with every joint driven, with each joint's measured reach" width="100%">
+  <br><sub>The Isaac review's contact sheet: at rest, every joint driven both ways, each joint's reach.</sub>
+</p>
+
+| Check | What it does |
+|---|---|
+| NVIDIA validator | [simready-validate](https://pypi.org/project/simready-validate/), profile Robotics-Prop 4.0.0 |
+| Isaac review | RTX renders, every joint driven both ways, settle test |
+| Physics probe | tilt, a hand's push on each part, lift and shake, a box on top |
+| Poses | overlaps, the ground and openings, without Isaac |
+| Critics + refuter | fresh eyes on the renders; every claim checked against the files |
+
+## Modes, measured
+
+Eight cases (five prompts, three photos), judged the same way:
+
+| Mode | Validator | Joint review | Drops (¼ h, 0.5 m) | Probe | Cost per asset |
+|---|:---:|:---:|:---:|:---:|---|
+| Quick, Sonnet builder | 8/8 | 8/8 | 8/8 · 8/8 | 5/8 | $2 – 7 |
+| Quick, Opus builder | 8/8 | 8/8 | 6/8 · 7/8 | 4/8 | $5 – 16 |
+| Standard, Sonnet builder | 8/8 | 8/8 | 8/8 · 7/8 | 4/8 | $7 – 26 |
+| Standard, Opus builder | 8/8 | 8/8 | 7/8 · 7/8 | 5/8 | $15 – 34 |
+| Standard, TRELLIS.2 meshes | 8/8 | 7/8 | 7/8 · 7/8 | 3/8 | $13 – 45 |
+| Max | 8/8 | 8/8 | 7/8 · 8/8 | 4/8 | $21 – 67 |
+
+- Quick + Sonnet passes every physics check; the extra rounds buy fidelity.
+- Probe misses are the same in every mode: no joint friction in the kit yet.
+
+## Install
+
+```text
+/plugin marketplace add serionist/simready-forge
+/plugin install simready-forge@simready-forge
+```
+
+| You need | For |
+|---|---|
+| [uv](https://docs.astral.sh/uv/) | everything |
+| Isaac Sim 5.x / 6.x + NVIDIA RTX GPU | the review and the probe (else a software preview) |
+| ComfyUI + TRELLIS.2 | generated meshes (optional) |
+
+Working on the kit itself? Set `SIMREADY_FORGE_DEV` to your clone.
+
+## The kit, by hand
+
+```python
+from build123d import Box, Pos
+from simready_forge import Asset, validate
+
+asset = Asset("storage_box", "simready_assets", label="box", qcode="Q188075", units="mm")
+pine = asset.material("pine", color=(0.78, 0.62, 0.42), density=500, nonvisual=("wood", "none"))
+box, lid = asset.body("box"), asset.body("lid")
+asset.add(box, "box", Pos(0, 0, 150) * Box(400, 300, 300), pine, collider="box")
+asset.add(lid, "lid", Pos(0, 0, 310) * Box(400, 300, 20), pine, collider="box")
+asset.revolute("hinge", box, lid, anchor=(0, 150, 300), axis="X", limits=(-110, 0), hold=1)
+validate(asset.save())
+```
+
+## Docs
+
+[Usage](https://github.com/serionist/simready-forge/blob/main/docs/USAGE.md) · [Contributing](https://github.com/serionist/simready-forge/blob/main/CONTRIBUTING.md) · [Security](https://github.com/serionist/simready-forge/blob/main/SECURITY.md) ·
+[Changelog](https://github.com/serionist/simready-forge/blob/main/CHANGELOG.md) · [Releasing](https://github.com/serionist/simready-forge/blob/main/docs/releasing.md)
+
+## Licence
+
+[MIT](https://github.com/serionist/simready-forge/blob/main/LICENSE). Not affiliated with NVIDIA; SimReady, Omniverse and Isaac Sim are NVIDIA's trademarks.

simready_forge-0.1.0/README.md

@@ -0,0 +1,129 @@
+<h1 align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/logo-dark.svg">
+    <img src="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/logo.svg" alt="simready-forge" width="520">
+  </picture>
+</h1>
+
+<p align="center"><b>Type what you want, or attach a photo. Get an NVIDIA SimReady asset that simulates.</b></p>
+
+<p align="center">
+  <a href="https://github.com/serionist/simready-forge/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/serionist/simready-forge/actions/workflows/ci.yml/badge.svg?branch=main"></a>
+  <a href="https://github.com/serionist/simready-forge/actions/workflows/codeql.yml"><img alt="CodeQL" src="https://github.com/serionist/simready-forge/actions/workflows/codeql.yml/badge.svg?branch=main"></a>
+  <a href="https://github.com/serionist/simready-forge/blob/main/LICENSE"><img alt="Licence: MIT" src="https://img.shields.io/badge/licence-MIT-007ec6"></a>
+  <a href="https://www.python.org/"><img alt="Python 3.12 | 3.13" src="https://img.shields.io/badge/python-3.12%20%7C%203.13-3776ab?logo=python&logoColor=white"></a>
+  <a href="https://docs.anthropic.com/en/docs/claude-code"><img alt="Claude Code plugin" src="https://img.shields.io/badge/Claude%20Code-plugin-d97757"></a>
+  <a href="#how-an-asset-is-checked"><img alt="SimReady: Robotics-Prop 4.0.0" src="https://img.shields.io/badge/SimReady-Robotics--Prop%204.0.0-1f7a8c"></a>
+  <a href="https://openusd.org/"><img alt="OpenUSD" src="https://img.shields.io/badge/OpenUSD-26.11-4a4a4a"></a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/showcase.jpg" alt="Eight assets made by simready-forge: a desk lamp, a rangefinder camera, a bottle, a nightstand, a running shoe, a pipe pile, a cable drum and a barricade" width="100%">
+  <br><sub>Eight assets made in Max mode, rendered in Isaac Sim by the review that checks them.</sub>
+</p>
+
+```text
+/simready-forge:make a 180 mm desk lamp with an adjustable arm, a weighted base and a translucent shade
+```
+
+A Claude Code plugin and a Python kit. One prompt or photo in; out comes:
+
+- **OpenUSD** (NVIDIA SimReady, Robotics-Prop 4.0.0) with real dimensions, materials and physics
+- **Every joint the real object has**, driven and measured in Isaac Sim
+- **URDF and GLB** exports, a report, and the build script to tweak and rerun
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/joints.webp" alt="A desk lamp, a camera, a nightstand and a barricade, at rest and with every joint driven" width="80%">
+  <br><sub>At rest, then every joint driven: the review watches each mechanism move.</sub>
+</p>
+
+## How it works
+
+```mermaid
+flowchart LR
+    R["Prompt or photo"] --> S["Spec<br/>parts, joints,<br/>materials"]
+    S --> B["Builder<br/>build123d + kit,<br/>or TRELLIS.2"]
+    B --> V["NVIDIA validator"]
+    V --> I["Isaac Sim review<br/>every joint driven"]
+    I --> C["Critics + refuter"]
+    C -- "findings" --> B
+    C -- "clean" --> P["Package + report"]
+```
+
+| Mode | What runs |
+|---|---|
+| **Quick** | one builder, one fix round at most |
+| **Standard** | one builder, then critics and a refuter until clean (≤ 4 rounds) |
+| **Max** | three builders, a blind judge picks one, then Standard on it |
+
+Asked once, remembered per session, project or always. Override per run: `mode=max`, `builder=opus`, `effort=high`.
+
+## How an asset is checked
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/serionist/simready-forge/main/docs/assets/review-sheet.jpg" alt="The Isaac review's contact sheet for a desk lamp: views at rest and with every joint driven, with each joint's measured reach" width="100%">
+  <br><sub>The Isaac review's contact sheet: at rest, every joint driven both ways, each joint's reach.</sub>
+</p>
+
+| Check | What it does |
+|---|---|
+| NVIDIA validator | [simready-validate](https://pypi.org/project/simready-validate/), profile Robotics-Prop 4.0.0 |
+| Isaac review | RTX renders, every joint driven both ways, settle test |
+| Physics probe | tilt, a hand's push on each part, lift and shake, a box on top |
+| Poses | overlaps, the ground and openings, without Isaac |
+| Critics + refuter | fresh eyes on the renders; every claim checked against the files |
+
+## Modes, measured
+
+Eight cases (five prompts, three photos), judged the same way:
+
+| Mode | Validator | Joint review | Drops (¼ h, 0.5 m) | Probe | Cost per asset |
+|---|:---:|:---:|:---:|:---:|---|
+| Quick, Sonnet builder | 8/8 | 8/8 | 8/8 · 8/8 | 5/8 | $2 – 7 |
+| Quick, Opus builder | 8/8 | 8/8 | 6/8 · 7/8 | 4/8 | $5 – 16 |
+| Standard, Sonnet builder | 8/8 | 8/8 | 8/8 · 7/8 | 4/8 | $7 – 26 |
+| Standard, Opus builder | 8/8 | 8/8 | 7/8 · 7/8 | 5/8 | $15 – 34 |
+| Standard, TRELLIS.2 meshes | 8/8 | 7/8 | 7/8 · 7/8 | 3/8 | $13 – 45 |
+| Max | 8/8 | 8/8 | 7/8 · 8/8 | 4/8 | $21 – 67 |
+
+- Quick + Sonnet passes every physics check; the extra rounds buy fidelity.
+- Probe misses are the same in every mode: no joint friction in the kit yet.
+
+## Install
+
+```text
+/plugin marketplace add serionist/simready-forge
+/plugin install simready-forge@simready-forge
+```
+
+| You need | For |
+|---|---|
+| [uv](https://docs.astral.sh/uv/) | everything |
+| Isaac Sim 5.x / 6.x + NVIDIA RTX GPU | the review and the probe (else a software preview) |
+| ComfyUI + TRELLIS.2 | generated meshes (optional) |
+
+Working on the kit itself? Set `SIMREADY_FORGE_DEV` to your clone.
+
+## The kit, by hand
+
+```python
+from build123d import Box, Pos
+from simready_forge import Asset, validate
+
+asset = Asset("storage_box", "simready_assets", label="box", qcode="Q188075", units="mm")
+pine = asset.material("pine", color=(0.78, 0.62, 0.42), density=500, nonvisual=("wood", "none"))
+box, lid = asset.body("box"), asset.body("lid")
+asset.add(box, "box", Pos(0, 0, 150) * Box(400, 300, 300), pine, collider="box")
+asset.add(lid, "lid", Pos(0, 0, 310) * Box(400, 300, 20), pine, collider="box")
+asset.revolute("hinge", box, lid, anchor=(0, 150, 300), axis="X", limits=(-110, 0), hold=1)
+validate(asset.save())
+```
+
+## Docs
+
+[Usage](https://github.com/serionist/simready-forge/blob/main/docs/USAGE.md) · [Contributing](https://github.com/serionist/simready-forge/blob/main/CONTRIBUTING.md) · [Security](https://github.com/serionist/simready-forge/blob/main/SECURITY.md) ·
+[Changelog](https://github.com/serionist/simready-forge/blob/main/CHANGELOG.md) · [Releasing](https://github.com/serionist/simready-forge/blob/main/docs/releasing.md)
+
+## Licence
+
+[MIT](https://github.com/serionist/simready-forge/blob/main/LICENSE). Not affiliated with NVIDIA; SimReady, Omniverse and Isaac Sim are NVIDIA's trademarks.

simready_forge-0.1.0/docs/USAGE.md

@@ -0,0 +1,81 @@
+# Using simready-forge
+
+Ask for an asset in plain words, with a photo if you have one, and the `make` skill plans it, builds it, checks it and
+reports. This page covers the skills, the choices, what comes out, and the kit for scripts written by hand.
+
+## The skills
+
+| Command | What it does |
+|---|---|
+| `/simready-forge:make <what>` | plans, builds, validates, reviews and reports one asset |
+| `/simready-forge:review <asset.usda>` | the validator, the Isaac review and the critics on an existing asset |
+| `/simready-forge:settings` | shows and changes the remembered choices |
+
+`make` also starts on its own when you ask Claude to make a SimReady, simulation-ready, 3D, CAD or USD asset.
+
+## The choices
+
+The first `make` asks how to run, once, and remembers the answers for the session, the project or always. Words in the
+request override them for one run: `mode=max`, `builder=opus`, `effort=high`, `critics=3`, `geometry=hybrid`,
+`trellis=high`, `formats=usd,urdf`, `articulation=main`, `out=assets/`.
+
+| Choice | Values | Default |
+|---|---|---|
+| mode | `quick` (one builder, no critics, one fix round at most), `standard` (a builder, critics until clean), `max` (2-3 builders, a blind judge, critics, a refuter) | `standard` |
+| builder and critic models | `sonnet`, `opus`, `haiku`, `fable`, or `inherit` (this session's) | Sonnet builds, Opus judges |
+| builder effort | `low` to `max`, or `inherit` (this session's `/effort`) | `inherit` |
+| critics | `none`, a number of rounds, or `auto` (until no blocker or major is left) | `auto`, at most 4 |
+| geometry | `auto` (per part), `cad`, `mesh` (local TRELLIS.2), `hybrid` | `auto` |
+| mesh effort | `low` (1 candidate), `medium` (2), `high` (4, denser) | `medium` |
+| formats | `usd` always, plus `urdf`, `glb` | all three |
+| mechanisms | `all` real ones, `main` ones, `static` | `all` |
+
+## What comes out
+
+```text
+simready_assets/
+  <name>/usd/<name>.usda            the SimReady package (Robotics-Prop 4.0.0), with textures/ and .thumbs/
+  <name>_exports/urdf/<name>.urdf    links, inertia, joints, OBJ visuals, STL colliders
+  <name>_exports/<name>.glb          the rest pose with PBR materials
+  <name>_reports/                    spec.md, structure.json, validate.json, review/, round-<n>.md, builder.md, cost.json
+  build_<name>.py                    the build script: change it and run it again
+```
+
+The report gives the bodies and joints with each joint's measured reach, the materials with their physics values, the
+validator's verdict and the features it passed, the critics' rounds, the cost per role and what was simplified.
+
+## Requirements
+
+| What | For |
+|---|---|
+| [uv](https://docs.astral.sh/uv/) | everything: it fetches Python 3.12 and the kit |
+| Isaac Sim (5.x or 6.x, its Python) | the RTX review and the PhysX checks; without it the review is a software preview and says physics was not checked |
+| ComfyUI with TRELLIS.2 and Z-Image-Turbo | generated meshes (`geometry=mesh` or `hybrid`) |
+
+The kit finds Isaac Sim's Python through `SIMREADY_FORGE_ISAAC`, `ISAACSIM_PYTHON` or the `isaac_python` setting, and
+ComfyUI through `COMFYUI_URL` or the `comfyui_url` setting.
+
+## The kit, for scripts written by hand
+
+```python
+from build123d import Box, Pos
+from simready_forge import Asset, validate
+
+asset = Asset("storage_box", "simready_assets", label="box", qcode="Q188075", units="mm")
+pine = asset.material(
+    "pine",
+    color=(0.78, 0.62, 0.42),
+    roughness=0.7,
+    friction=(0.5, 0.4),
+    restitution=0.1,
+    density=500,
+    nonvisual=("wood", "none"),
+)
+body = asset.body("box")
+asset.add(body, "box", Pos(0, 0, 150) * Box(400, 300, 300), pine, collider="box")
+validate(asset.save())
+```
+
+`simready-forge example --show` prints a full example with a hinged door and a drawer; `simready-forge --help` lists
+the commands (`validate`, `review`, `probe`, `poses`, `inspect`, `trellis`, `views`, `qcode`, `prefs`, `cost`,
+`example`).

simready_forge-0.1.0/docs/assets/icon.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128" role="img" aria-label="simready-forge">
+  <g>
+    <defs>
+      <linearGradient id="lid" x1="0" y1="0" x2="1" y2="1">
+        <stop offset="0" stop-color="#ffb35c"/><stop offset="1" stop-color="#f28c28"/>
+      </linearGradient>
+    </defs>
+    <polygon points="28,64 64,84 64,122 28,102" fill="#1f7a8c"/>
+    <polygon points="64,84 100,64 100,102 64,122" fill="#14505c"/>
+    <polygon points="64,44 100,64 64,84 28,64" fill="#0c2e35"/>
+    <polygon points="64,44 100,64 82,30 46,10" fill="url(#lid)"/>
+    <path d="M 22 58 A 46 46 0 0 1 36 16" fill="none" stroke="#f28c28" stroke-width="4" stroke-linecap="round"
+      stroke-dasharray="2 7"/>
+    <path d="M 30 14 L 38 14 L 36 22" fill="none" stroke="#f28c28" stroke-width="4" stroke-linecap="round"
+      stroke-linejoin="round"/>
+  </g>
+</svg>

simready_forge-0.1.0/docs/assets/logo-dark.svg

@@ -0,0 +1,20 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="520" height="96" viewBox="0 0 520 96" role="img" aria-label="simready-forge">
+  <!-- The logo: the mark (icon.svg) and the wordmark; textLength keeps the wordmark's width whatever font the viewer has. -->
+  <g transform="translate(0 0) scale(0.75)">
+    <defs>
+      <linearGradient id="lid" x1="0" y1="0" x2="1" y2="1">
+        <stop offset="0" stop-color="#ffb35c"/><stop offset="1" stop-color="#f28c28"/>
+      </linearGradient>
+    </defs>
+    <polygon points="28,64 64,84 64,122 28,102" fill="#1f7a8c"/>
+    <polygon points="64,84 100,64 100,102 64,122" fill="#14505c"/>
+    <polygon points="64,44 100,64 64,84 28,64" fill="#0c2e35"/>
+    <polygon points="64,44 100,64 82,30 46,10" fill="url(#lid)"/>
+    <path d="M 22 58 A 46 46 0 0 1 36 16" fill="none" stroke="#f28c28" stroke-width="4" stroke-linecap="round"
+      stroke-dasharray="2 7"/>
+    <path d="M 30 14 L 38 14 L 36 22" fill="none" stroke="#f28c28" stroke-width="4" stroke-linecap="round"
+      stroke-linejoin="round"/>
+  </g>
+  <text x="112" y="64" font-family="Segoe UI, Helvetica Neue, Arial, sans-serif" font-size="50" font-weight="700"
+    textLength="400" lengthAdjust="spacingAndGlyphs" fill="#eef4f6">simready<tspan fill="#ffb35c">-forge</tspan></text>
+</svg>

simready_forge-0.1.0/docs/assets/logo.svg

@@ -0,0 +1,20 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="520" height="96" viewBox="0 0 520 96" role="img" aria-label="simready-forge">
+  <!-- The logo: the mark (icon.svg) and the wordmark; textLength keeps the wordmark's width whatever font the viewer has. -->
+  <g transform="translate(0 0) scale(0.75)">
+    <defs>
+      <linearGradient id="lid" x1="0" y1="0" x2="1" y2="1">
+        <stop offset="0" stop-color="#ffb35c"/><stop offset="1" stop-color="#f28c28"/>
+      </linearGradient>
+    </defs>
+    <polygon points="28,64 64,84 64,122 28,102" fill="#1f7a8c"/>
+    <polygon points="64,84 100,64 100,102 64,122" fill="#14505c"/>
+    <polygon points="64,44 100,64 64,84 28,64" fill="#0c2e35"/>
+    <polygon points="64,44 100,64 82,30 46,10" fill="url(#lid)"/>
+    <path d="M 22 58 A 46 46 0 0 1 36 16" fill="none" stroke="#f28c28" stroke-width="4" stroke-linecap="round"
+      stroke-dasharray="2 7"/>
+    <path d="M 30 14 L 38 14 L 36 22" fill="none" stroke="#f28c28" stroke-width="4" stroke-linecap="round"
+      stroke-linejoin="round"/>
+  </g>
+  <text x="112" y="64" font-family="Segoe UI, Helvetica Neue, Arial, sans-serif" font-size="50" font-weight="700"
+    textLength="400" lengthAdjust="spacingAndGlyphs" fill="#1b2a30">simready<tspan fill="#f28c28">-forge</tspan></text>
+</svg>