forgecad-reconstruct-from-images

Reconstructs parametric ForgeCAD models from reference images using multi-view evidence and camera calibration.

927|103|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/KoStard/forgecad-public-kit --skill forgecad-reconstruct-from-images
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forgecad-reconstruct-from-images
Source: https://github.com/KoStard/forgecad-public-kit/tree/main/skills/forgecad-reconstruct-from-images
Command: npx skills add https://github.com/KoStard/forgecad-public-kit --skill forgecad-reconstruct-from-images

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pillow, and includes scripts (resource) components.

What problem does it solve?

Rebuilding a real 3D object from reference photos often produces models that only look right from one camera angle. This Skill enforces an evidence-driven workflow that infers the complete parametric object — including hidden sides, scale, and manufacturing posture — before matching any reference view.

Core Features & Use Cases

  • Real Object Brief: A mandatory written gate covering artifact identity, assumed scale, part boundaries, and inferred hidden-side geometry before any modeling begins.
  • Camera Calibration & Comparison Boards: Calibrates one camera per reference image and renders side-by-side reference-vs-model boards with the bundled Pillow-based compare_images.py script.
  • Multi-Image Constraint Solving: Weights every reference image as a constraint on one shared geometry, iterating from blockout to canonical views to final inspection.
  • Use Case: Given front, side, and rear photos of a mechanical bracket, produce a parametric .forge.js model that holds up from all canonical views, passes forgecad run, and ships with comparison boards and inspection evidence.

Quick Start

Use the forgecad-reconstruct-from-images skill to infer the real object from these reference images and build a ForgeCAD model that holds up from all views.

Frequently Asked Questions about forgecad-reconstruct-from-images

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reconstruct a 3D CAD model from reference photos?

Stage the images, record visible facts and unknowns per image, write a Real Object Brief defining identity, scale, and hidden geometry, then build a coarse blockout before calibrating cameras. Validate with comparison boards and canonical renders rather than matching a single view.

How do I create a side-by-side reference vs render comparison image?

Run the bundled compare_images.py script with uv, passing the reference image, the ForgeCAD render, and an output path. It uses Pillow to build a labeled side-by-side PNG board with contain or cover fit modes.

Why does my reconstructed model only look correct from the reference camera angle?

The model was likely built to match pixels instead of inferring the real object. The workflow requires modeling hidden sides and canonical front, back, top, and bottom forms first, so geometry stays coherent from every view.

Can I use multiple reference images with different camera angles?

Yes. Each image gets its own calibrated camera, evidence list, and confidence weighting, and one shared geometry is optimized against the whole set. Distorted or decorative images are explicitly downweighted in the report.

What are the limitations of image-based CAD reconstruction?

Images underdetermine hidden geometry, exact scale, and manufacturing details, so the skill records honest assumptions in the Real Object Brief. When identity or scale is too ambiguous, it defers to a design-spec skill before modeling.