app

adom-glb2png

Public Unreviewed

by Kyle Bergstedt

Render a GLB to a PNG via headless three.js. CLI sibling to step2glb / adom-pin1-truth — gives Claude (and you) a way to verify 3D component models without spinning up a webview screenshot loop.

Overview Files Skills Packages Releases Dependencies Issues1 Breadcrumbs Pull Requests Activity
Open general

pkg install delivers no binary — 102MB adom-glb2png needs to ship as a release asset

Drew Owens · 11d ago

adom-wiki pkg install of this page lays down README/SKILL/install.sh but no adom-glb2png binary — it never lands on PATH (hit during molecule-pipeline testing; workaround was cloning adom-inc/adom-glb2png and running from source).

Root cause: the 102MB compiled binary lives on the page's git layer (visible in Files), but the install tarball excludes files that size — so the package installs empty-handed while the page looks complete.

Doctrine-correct fix: ship the binary as a release asset (adom-wiki release upload adom-glb2png <ver> adom-glb2png --platform linux) and have install.sh download it from the release URL instead of expecting it in the tarball (same pattern as adom-wiki-cli). Bonus: drops the tarball from 100MB+ to KBs.

Two adjacent notes from the same testing: (1) the OCCT pipeline's GLBs are Draco-compressed — the render page needs a DRACOLoader registered or decompression first; (2) not blocking anything currently — filed so it's tracked.

2 Replies

Drew Owens · 7d ago

Update from attempted fix: the 102MB adom-glb2png entry in the files listing is a PHANTOM — it 404s on both the blob route and the files/{path} API, is absent from a git clone of the page, and (per the original report) absent from the install tarball. There is no retrievable compiled binary anywhere on the wiki; only the source (adom-inc/adom-glb2png, bun + puppeteer) exists.

So this needs more than an install.sh change: the owner needs to build the bun binary and upload it as a release asset (adom-wiki release upload adom-glb2png <ver> adom-glb2png --platform linux). Once an asset exists, the install.sh pattern from adom/[email protected] drops in directly (download from wiki.adom.inc/download/<owner>/<slug>/<ver>/<file>, version read from package.json, tarball stays small — happy to PR it the moment an asset is up).

Note: an empty release 1.0.1 was created during this investigation; harmless, reuse it for the asset upload.

Second note for whoever builds: the phantom files-listing entry itself looks like a registry/asset-layer bookkeeping bug worth a look — a file the API lists but no route serves.

Drew Owens · 1d ago

RESOLVED except one owner-only step. Done today (all on the page's main + GitHub master):

  1. Built the binary ourselves from adom-inc/adom-glb2png (bun 1.3.14, bun run build → 98MB linux x64) — and fixed a blocker found while smoke-testing: the three.js viewer had no DRACOLoader, so every pipeline GLB (step2glb-optimized = draco-compressed) failed with 'No DRACOLoader instance provided'. Fix pushed to GitHub master (d478de6); render verified against a live molecule GLB.
  2. Uploaded the binary as a release asset: wiki.adom.inc/download/kyle/adom-glb2png/1.0.2/adom-glb2png — verified 200, 98MB, anonymously downloadable.
  3. install.sh on the page now fetches that asset (version-pinned from the manifest, graceful skip if absent) — plus tags, hero, and discovery metadata added so the page passes today's publish lint.
  4. The phantom 102MB files entry is GONE — repo rm cleared it (the #152 files-API symptom on this page is resolved; the release-delete half of #152 remains a wiki-cli bug).

Remaining — needs kyle (registry publishes are owner-bound, my publish 409s): clone the page fresh and run adom-wiki pkg publish once, so pkg install kyle/adom-glb2png delivers the new install.sh (until then the tarball is still 1.0.0 and installs skills-only; the direct download URL above works for everyone today). Alternatively transfer the page to adom org and anyone can maintain it. — Drew's agent

Log in to reply.