DWG · HERMES AGENT PLUGIN

Photo→Part

Turn photos, a few measurements, or a messy 3D scan into a parametric part you can print or edit.

  1. Photo
  2. Scale
  3. Segment
  4. Spec
  5. Approval
  6. Build
  7. Render
  8. Compare
  9. Refine
Envelope of the checked-in plate clip sample: 51 by 72.6 by 6 millimetres, front and side views. 51 72.6 6 FRONT SIDE ENVELOPE ONLY examples/ plate-clip UNITS: mm
Fig. 0 — bounding envelope of the sample in examples/plate-clip (51 × 72.6 × 6 mm).

A General notes

photo-to-part is one skill, photo-to-part:photo-to-printable-part, plus six tools. Hand it a photo, a few measurements, or a messy 3D scan, and it works toward a parametric part you can print or edit: templates first, then a local Python build behind an approval prompt, then validation and comparison renders held next to your photo.

On Hermes 0.23 or newer, an optional Part studio pane shows the stage, photo overlay, renders, history, scale and trust, approval, and output paths. The tools install without it.

  1. One skill (photo-to-part:photo-to-printable-part) and six tools
  2. Optional Part studio Desktop pane on Hermes 0.23+ showing stage, photo overlay, renders, history, scale/trust, approval, and output paths
  3. Templates including plate clip, spur gear, scroll, and strap hinge; builds are local Python with an approval prompt
  4. Validate watertight meshes and stated sizes; heal messy scans; render comparison views next to the photo
  5. User-stated millimetre values are not replaced by a photo measurement
  6. No credentials, no printer connection, no network from the tools; chat photos still go to your model provider

B Bill of materials

ItemToolFunctionQty
1photo_part_validateWatertightness, shell count, bounding box, circular bores, printability, and a spec or --dim check1
2photo_part_renderFront, side, top and iso previews, an eight-view comparison sheet, a side-by-side and a silhouette overlay with IoU1
3photo_part_healWeld, fill holes, and keep the largest shell of a scan1
4photo_part_templateA watertight block from a template (plate, L-bracket, hinge, thread, spur gear, spiral scroll, strap hinge, …)1
5photo_part_measurePixels per millimetre from a coin, a ruler, or an ArUco/AprilTag marker1
6photo_part_buildRuns one local .py file after Hermes asks for approval. No shell1

C Details: use cases

  1. Detail D. Ask for a replacement part from a photo and a few measurements, then print a validated STL

  2. Detail E. Make a fit-test print of a plate clip (the checked-in sample is 51 × 72.6 × 6 mm in examples/plate-clip)

  3. Detail F. Turn a messy 3D scan into a healed solid with photo_part_heal, then validate and render views

  4. Detail G. Generate a spur gear from stated module, tooth count, and bore, after the template path has been tried

  5. Detail H. Model a strap hinge (one or two scrolls on a straight strap) and compare the photo overlay in the Part studio pane

  6. Detail I. Hold rendered front/iso/side/top views next to the original photograph to check the fit before you print

J Section J–J: the submission video

Submission video · 1:00 · original post on X

K Views

  • Reference photo of a door hinge beside the modelled part, front view in millimetres.
  • Part studio pane for gear18: photo overlay, render, overlay IoU 0.944, dimensions 30 × 29.7 × 8 mm, ready to deliver.
  • Part studio pane with a strap hinge ready to deliver.
  • Part studio pane with a second strap hinge variant ready.
  • Four views of the sample plate clip.
  • Synthetic reference beside the front view of the plate clip.
  • Plate clip, isometric render.
  • Plate clip, front render.
  • Plate clip, side render.
  • Plate clip, top render.
  • Synthetic reference image for the plate clip example.
  • Part studio pane mid-run.
  • Part studio pane after a completed run.
  • photo-to-part catalog banner.

L Assembly instructions

Install the plugin/ subdirectory so evals/ and tests/ are not copied into Hermes:

hermes plugins install mojomast/hermes-photo-to-part/plugin --ref d924991f56ad4cf7b94e33f2ac5dcb6cf24fac5f
hermes plugins enable photo-to-part

Until catalog acceptance the README also shows --no-enable first so you can read the code. After catalog acceptance the reviewed install is hermes plugins install photo-to-part. Load the skill with skill_view("photo-to-part:photo-to-printable-part"). Enabling the plugin installs its Python packages from PyPI after Hermes dependency consent. A STEP solid needs CadQuery or build123d in the project environment (optional, can take several minutes). A root install without /plugin is refused.

README documents unittest discover -s tests and hermes plugins validate / doctor --ci, but does not publish a test count.

M Referenced documents

TitlePhoto to Part
Pluginphoto-to-partRevv0.1.22
Dwg no.d924991f56Tools6
Video1:00Unitsmm
DrawnKyle Durepos · mojomast
Original