simready-forge 0.1.0__py3-none-any.whl

simready_forge/validate.py

@@ -0,0 +1,66 @@
+"""NVIDIA's official SimReady validator (simready-validate 2026.8) on profile Robotics-Prop 4.0.0."""
+
+import json
+from pathlib import Path
+
+from .kit import PROFILE, PROFILE_VERSION
+
+
+def feature_results(summary):
+    """{feature id: passed} from the validator's features summary."""
+    items = summary.items() if isinstance(summary, dict) else enumerate(summary or [])
+    out = {}
+    for key, value in items:
+        feature, passed = key, value
+        if isinstance(value, dict):
+            feature = value.get("id") or value.get("feature") or key
+            passed = value.get("passed", value.get("status"))
+        out[str(feature)] = passed
+    return out
+
+
+def validate(asset, out=None, quiet=False):
+    """Validate a .usda; write <name>_reports/validate.json (or `out`) and return the summary."""
+    import simready.validate as sv
+
+    asset = Path(asset).resolve()
+    if out is None:
+        out = asset.parent.parent.parent / f"{asset.stem}_reports" / "validate.json"
+    out = Path(out)
+    out.parent.mkdir(parents=True, exist_ok=True)
+    sv.initialize(rules_and_requirements_paths=[], features_paths=[], profiles_paths=[])
+    config = sv.AssetValidationConfig(
+        asset_path=str(asset), profile_id=PROFILE, profile_version=PROFILE_VERSION, write_metadata=False
+    )
+    result = sv.validate_asset_list([config], report_file_path=str(out.with_suffix(".nvidia.json")))[0]
+    if result is None or not result.features_summary:
+        summary = {"asset": str(asset), "passed": False, "status": "no-result"}
+    else:
+
+        def record(item):
+            return {k: str(getattr(item, k)) for k in ("code", "message", "at") if getattr(item, k, None) is not None}
+
+        passed = bool(sv.features_summary_passed(result.features_summary) and not result.issues)
+        summary = {
+            "asset": str(asset),
+            "profile": f"{PROFILE}@{PROFILE_VERSION}",
+            "passed": passed,
+            "status": "passed" if passed else "failed",
+            "mandatory_failures": len(result.issues),
+            "optional_findings": len(result.soft_issues),
+            "features": feature_results(result.features_summary),
+            "mandatory": [record(i) for i in result.issues],
+            "optional": [record(i) for i in result.soft_issues],
+        }
+    out.write_text(json.dumps(summary, indent=1, default=str), encoding="utf-8")
+    if not quiet:
+        print(
+            f"{'PASSED' if summary['passed'] else 'FAILED'}: {summary.get('mandatory_failures')} mandatory failures, "
+            f"{summary.get('optional_findings')} optional findings (report: {out})"
+        )
+        features = sorted(k for k, v in summary.get("features", {}).items() if v is True)
+        if features:
+            print("  features passed: " + ", ".join(features))
+        for issue in summary.get("mandatory", [])[:25]:
+            print(f"  [{issue.get('code', '')}] {issue.get('message', '')[:300]}  at {issue.get('at', '')[:120]}")
+    return summary

simready_forge-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,22 @@
+simready_forge/__init__.py,sha256=-ptF5l_G03kyzs2kLvLa9argPtYSOH4OJhkaedFAUsU,474
+simready_forge/cli.py,sha256=zyOT0lRQUsLf3-7ruOX6KPKdB1zbNlC37Ak2a11YO_Q,9169
+simready_forge/cost.py,sha256=s1i2_Oea3MwvLCGQXfkL6EkWoweW6T0HbRRwmYYpDL0,4983
+simready_forge/export.py,sha256=X-FfIRrJ6MVyMSN_LrItxDpGn7JxipG8c9krf-sdGRM,7807
+simready_forge/isaac_probe.py,sha256=VIrOVD9DwLJEtfaNVSuivY8bZVoy-GUnhyq6NccM3HQ,38911
+simready_forge/isaac_review.py,sha256=zSJaIddr_L1Sf1CgExt1loFoOBwsjwje3-MBnCXG2XQ,19971
+simready_forge/kit.py,sha256=mJ7p-zKJKlNYmHrbzZazJV8JEXQa8XNEcPUXqT9s2qw,50577
+simready_forge/poses.py,sha256=4zrvX-rWq5IRICtgR1kbeQoc6cO_vf0ggmVHoGmb2LU,14732
+simready_forge/prefs.py,sha256=4siJRRst-SgLUcGsGka-u7rbDgSBozv7bnpfUfLtgE0,4006
+simready_forge/preview.py,sha256=Yrtt3PjSQjP9NYFFvk-HNDqb_guaHl3fwivA75TOLBs,2979
+simready_forge/readback.py,sha256=OLXmx3U7FBCUo5DIJEWnOF0HQgN8dwaBWmTttH12Vyg,7604
+simready_forge/review.py,sha256=KLSQLxsmJVIYLKdgaTYKrLR8hPCHMqMqbI7vGQjMnS0,6780
+simready_forge/scan.py,sha256=ce6nXQPi1cB7_HXuB5J5XzrcCDPG0PcLumEt5mrVK4Q,6188
+simready_forge/trellis.py,sha256=naLKmnbyKGH7pkLp7dN8cFzLKHYMDPHT9QQgyZV6PYA,13854
+simready_forge/validate.py,sha256=OutxD7rEhR7Ywa6toFPXeCY-akYgpYi53mfejiXrh00,2987
+simready_forge/examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+simready_forge/examples/cabinet.py,sha256=EpzapRZ3LlP6llG_Z8NJtOfbXH3g3ukZ95rc1lgoO5I,5422
+simready_forge-0.1.0.dist-info/METADATA,sha256=DfixPbmTav21EX0KoKDziT50C41udykzWupc8oWYku4,8371
+simready_forge-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+simready_forge-0.1.0.dist-info/entry_points.txt,sha256=5ovwqDQHqsLe7TnEs72e_uuTy8yJ9zBZRxX-WHXJCdk,59
+simready_forge-0.1.0.dist-info/licenses/LICENSE,sha256=e2lbWThJjjhKF3ryLKZdVv0ID8xQ1cCu4SR8J8JdopY,1067
+simready_forge-0.1.0.dist-info/RECORD,,

simready_forge-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

simready_forge-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+simready-forge = simready_forge.cli:main

simready_forge-0.1.0.dist-info/licenses/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.