Skip to content
Back to search

gaussian-splat-to-blender-nodes

World to World Mapping: project-independent Blender node reconstruction and optional calibrated capture-texture mapping, with multi-view validation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gokayfem--gaussian-splat-to-blender-nodes/badge.svg)](/listings/gokayfem--gaussian-splat-to-blender-nodes)

HTML

<a href="/listings/gokayfem--gaussian-splat-to-blender-nodes"><img src="/api/listings/gokayfem--gaussian-splat-to-blender-nodes/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Agent Skills

npx skills add gokayfem/gaussian-splat-to-blender-nodes

Claude Code plugin

/plugin marketplace add gokayfem/gaussian-splat-to-blender-nodes
/plugin install gaussian-splat-to-blender-nodes@gaussian-splat-to-blender-nodes

Manual / Codex

git clone https://github.com/gokayfem/gaussian-splat-to-blender-nodes.git
cd gaussian-splat-to-blender-nodes
mkdir -p ~/.codex/skills
cp -R skills/gaussian-splat-to-blender-nodes ~/.codex/skills/

For Claude project-local use, copy the skill into `.claude/skills/`. See [adapters](adapters/README.md) for other agents. A skill-only install includes tools and the starter; clone the full repository for Garden.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "gaussian-splat-to-blender-nodes",
  3. "description": "World to World Mapping: project-independent Blender node reconstruction and optional calibrated capture-texture mapping, with multi-view validation.",
  4. "owner": {
  5. "name": "gokayfem",
  6. "url": "https://github.com/gokayfem"
  7. },
  8. "plugins": [
  9. {
  10. "name": "gaussian-splat-to-blender-nodes",
  11. "source": "./",
  12. "description": "World to World Mapping: project-independent Blender node reconstruction and optional calibrated capture-texture mapping, with multi-view validation.",
  13. "category": "development",
  14. "tags": [
  15. "agent-skills",
  16. "blender",
  17. "gaussian-splatting",
  18. "geometry-nodes",
  19. "procedural",
  20. "shader-nodes",
  21. "texture-projection"
  22. ]
  23. }
  24. ]
  25. }
README.md · README · 198 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # World to World Mapping
  2. **Gaussian splat to Blender nodes — reconstruct geometry, then optionally map captured appearance.**
  3. A project-independent agent skill and toolkit for measured reconstruction with native
  4. **Geometry Nodes, Shader Nodes and calibrated multi-view texture projection**. Built from
  5. the Garden study, in the spirit of [video-to-blender](https://github.com/gokayfem/video-to-blender)
  6. and [shader-skills](https://github.com/gokayfem/shader-skills).
  7. <p align="center">
  8. <img src="gallery/world-to-world-mapping.jpg" width="800" alt="World to World Mapping release: grey and textured Blender scene comparison">
  9. </p>
  10. [Watch the release video — grey/textured reveals and a matched 360° comparison](https://v3b.fal.media/files/b/0aafb407/k_VXzVOBiFnE1RwnpVGxF_world_to_world_mapping-gaussian_splat_to_blender_nodes.mp4)
  11. · [Read the skill](skills/gaussian-splat-to-blender-nodes/SKILL.md)
  12. · [Reusable prompts](prompts/README.md)
  13. · [Hybrid mapping guide](skills/gaussian-splat-to-blender-nodes/references/hybrid-projection.md)
  14. *The video shows the accepted Garden c26b hybrid experiment. Its mapped table and paving
  15. are baked evaluated meshes with packed appearance textures; other reconstructed parts retain
  16. node-based construction. The source scan and fitted hybrid assets are not bundled. See
  17. [media provenance and limitations](gallery/README.md). The installation name remains
  18. `gaussian-splat-to-blender-nodes`.*
  19. ## What it does
  20. This is an **agent-guided reconstruction workflow**, not a one-click splat-to-mesh converter.
  21. The splat provides observations; the output describes objects through meaningful geometry,
  22. parameters and materials that you can edit in Blender.
  23. ```text
  24. Splat reference → measured frame + cameras → semantic scene parts
  25. → Geometry Nodes + Shader Nodes → native audit + visual comparison
  26. → optional calibrated appearance mapping → hybrid review + packed blend
  27. ```
  28. | Included | Purpose |
  29. |---|---|
  30. | Installable agent skill | Acquisition, registration, construction, detail and candid critique |
  31. | Project-agnostic prompt pack | Full brief, whole-scene capture, part contracts, detail, critique and delivery |
  32. | Asset inspector | SHA-256 and limited PLY / SPLAT / KSPLAT metadata |
  33. | Shared camera tools | Validated coordinates and repeatable world/scan orbit manifests |
  34. | Native-scene audit | Remove the reference in memory; compare mesh and instance signatures |
  35. | Blender renderer | Sequential rendering of a shared camera manifest |
  36. | Still/video comparison | Strict frame pairing, labels and hashed evidence; optional FFmpeg MP4 |
  37. | Synthetic starter | Small editable GN table; no scan download required |
  38. | Hybrid mapping tools | UV preparation, depth/object visibility, robust projection, material-aware fallback and packed assembly |
  39. | Hybrid prompt/config | Per-project objects, material slots, cameras, source masks and appearance mode |
  40. | Garden study | Seven procedural parts, parameters and vendored node-building helpers |
  41. No automatic semantic segmentation, universal splat decoder or reference renderer is bundled.
  42. An audit pass proves specific structural checks; it does not prove visual resemblance.
  43. ## Install
  44. ### Agent Skills
  45. ```sh
  46. npx skills add gokayfem/gaussian-splat-to-blender-nodes
  47. ```
  48. ### Claude Code plugin
  49. ```text
  50. /plugin marketplace add gokayfem/gaussian-splat-to-blender-nodes
  51. /plugin install gaussian-splat-to-blender-nodes@gaussian-splat-to-blender-nodes
  52. ```
  53. ### Manual / Codex
  54. ```sh
  55. git clone https://github.com/gokayfem/gaussian-splat-to-blender-nodes.git
  56. cd gaussian-splat-to-blender-nodes
  57. mkdir -p ~/.codex/skills
  58. cp -R skills/gaussian-splat-to-blender-nodes ~/.codex/skills/
  59. ```
  60. For Claude project-local use, copy the skill into `.claude/skills/`. See
  61. [adapters](adapters/README.md) for other agents. A skill-only install includes tools and the
  62. starter; clone the full repository for Garden.
  63. ## Try it without a scan
  64. Requires **Python 3.10+** and **Blender 5.0+**. Local integration verification used Blender
  65. 5.0.1; validate other versions before relying on them. Substitute your Blender executable
  66. for `blender` if it is not on PATH.
  67. ```sh
  68. S=skills/gaussian-splat-to-blender-nodes
  69. blender -b --factory-startup --python-exit-code 1 \
  70. --python "$S/templates/starter.py" -- --out outputs/starter.blend
  71. blender -b --factory-startup outputs/starter.blend --python-exit-code 1 \
  72. --python "$S/scripts/audit_blend.py" -- --out outputs/starter-audit.json
  73. python3 "$S/scripts/cameras.py" --frames 4 --radius 3 --target 0 0 0.5 \
  74. --width 640 --height 480 --out outputs/starter-cameras.json
  75. blender -b --factory-startup outputs/starter.blend --python-exit-code 1 \
  76. --python "$S/scripts/render_manifest.py" -- \
  77. --manifest outputs/starter-cameras.json --out outputs/starter-views
  78. ```
  79. Width and Depth controls change the tabletop and supports. The starter is a pipeline test,
  80. not a reconstructed asset. The audit deletes its hidden synthetic reference point in memory
  81. and leaves the saved file unchanged.
  82. ## Reconstruct your scene
  83. Use the [full prompting guide](prompts/README.md), starting with the
  84. [copy-ready project brief](skills/gaussian-splat-to-blender-nodes/templates/prompts/project-brief.md).
  85. It generalizes the actual structure used for the study: source selection and whole-scene
  86. capture, shared measurements/cameras, scoped part builders, integrated blockout, detail
  87. correction and final evidence. It works for other scene types and with a single agent.
  88. The [capture guide](skills/gaussian-splat-to-blender-nodes/references/whole-scene-capture.md)
  89. explains how repeatable reference views came from the original splat: viewer/asset identity,
  90. exact camera and canvas settings, settled captures, shared world coordinates, coverage views,
  91. analysis maps and matched close-ups. This is reference capture, not splat training.
  92. For a shorter starting message, give your agent an authorized source, intended views and a
  93. quality target:
  94. > Use gaussian-splat-to-blender-nodes. Reconstruct this scene as editable native Blender
  95. > geometry and materials. First fingerprint the asset, establish a measured coordinate
  96. > frame, match the reference camera and identify the major objects. Build an integrated
  97. > coarse checkpoint before fine detail. Review side, opposite and detail views; be candid
  98. > about mismatches. Deliver source, parameters, blend and scan-removal evidence.
  99. Start with the [skill workflow](skills/gaussian-splat-to-blender-nodes/SKILL.md).
  100. Use the [part contract](skills/gaussian-splat-to-blender-nodes/templates/prompts/part-contract.md),
  101. [detail pass](skills/gaussian-splat-to-blender-nodes/templates/prompts/detail-pass.md) and
  102. [review prompt](skills/gaussian-splat-to-blender-nodes/templates/prompts/review-and-correction.md)
  103. as the project progresses.
  104. For a turntable, follow the [matched 360° guide](skills/gaussian-splat-to-blender-nodes/references/comparison-videos.md).
  105. Reference frames must come from a compatible viewer using the same camera manifest;
  106. the Blender renderer handles the native side.
  107. ## Map captured appearance onto your reconstruction
  108. Use the [hybrid mapping prompt](skills/gaussian-splat-to-blender-nodes/templates/prompts/hybrid-projection.md)
  109. when captured appearance is part of the intended result. Supply your own reconstructed
  110. scene and calibrated captures, then fill the
  111. [configuration template](skills/gaussian-splat-to-blender-nodes/templates/projection.json).
  112. Objects, materials, cameras, visibility masks and rejection rules are configuration inputs;
  113. the implementation contains no required Garden objects or fitted scene coordinates.
  114. The [step-by-step guide](skills/gaussian-splat-to-blender-nodes/references/hybrid-projection.md)
  115. covers the three commands: **prepare → project → assemble**. Install `requirements.txt` for
  116. the NumPy/SciPy/Pillow projector. Blender prepares evaluated UV surfaces and visibility maps;
  117. ordinary Python maps the captures; Blender packs the results onto selected mesh copies.
  118. Unseen/rejected texels retain the original material. Source-only occluders require masks or
  119. other explicit evidence; reconstructed depth alone cannot identify them.
  120. Choose unlit captured radiance or an approximate irradiance-divided lit material. Neither
  121. recovers clean physical albedo. Selected mapped surfaces require rebaking after geometry or
  122. UV edits; untouched procedural parts retain their live graphs. The original source is
  123. preserved, and immutable manifests tie geometry, captures and outputs together.
  124. ## Garden example
  125. Garden generates ground, table, vase/arrangement, tree, shrubs, boundary and structures
  126. from nodes. It includes fitted parameters and a sparse foliage control field, not the
  127. original Gaussian records. The default build requires no scan download.
  128. <details>
  129. <summary>View the table's editable Geometry Nodes graph</summary>
  130. ![Garden table Geometry Nodes](gallery/garden-table-nodes.jpg)
  131. </details>
  132. [Build instructions, provenance and limitations →](prompts/garden/README.md)
  133. The reference is the Mip-NeRF 360 Garden scene displayed by GaussianSplats3D. Original scans,
  134. decoded arrays and reference captures are not distributed here. No claim of perfect
  135. replication is made: construction, foliage, surface response and light still differ visibly.
  136. ## Development
  137. ```sh
  138. python3 -m pip install -r requirements.txt
  139. python3 -m unittest discover -s tests -v
  140. python3 tests/check_repository.py
  141. ```
  142. Tests cover coordinate invariants, malformed assets, comparison pairing, projection visibility,
  143. linear-light blending, material boundaries, fallback and artifact fingerprints. Blender checks
  144. are documented in [tests](tests/README.md). Python CI alone does not validate rendering.
  145. See [AGENTS.md](AGENTS.md) for contributor rules.
  146. ## Credits and license
  147. MIT for repository code and instructions. Vendored nodekit/library retain their
  148. [original license](prompts/garden/vendor/LICENSE.video-to-blender).
  149. Datasets and third-party media retain their own terms; the code license does not grant
  150. rights to those assets. See [CREDITS.md](CREDITS.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.