Skip to content
Back to search

photo-to-3d

SkillWorks with Claude CodeGitHub

Claude Code skill: photos of an object -> a parametric 3D model built in Blender (GLB, OBJ, .blend, printable STLs)

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lordnukem--photo-to-3d/badge.svg)](/listings/lordnukem--photo-to-3d)

HTML

<a href="/listings/lordnukem--photo-to-3d"><img src="/api/listings/lordnukem--photo-to-3d/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

git clone https://github.com/lordnukem/photo-to-3d.git
cd photo-to-3d
./install.sh          # links the skill into ~/.claude/skills, makes ~/photo-to-3d/.venv, runs a check

To keep models and the environment somewhere other than `~/photo-to-3d`, run `PHOTO3D_HOME=/path ./install.sh` and export `PHOTO3D_HOME` in your shell profile.

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.

README.md · README · 87 lines
  1. # photo-to-3d
  2. A [Claude Code](https://claude.com/claude-code) skill that turns photos of an object into a 3D model built in
  3. Blender. Give Claude one or more photos, plus any notes (sizes, materials, what the model is for), and it:
  4. 1. studies the photos and writes down the parts, the sizes (and where each one came from) and the camera angles;
  5. 2. writes a parametric Blender script for the object with this skill's modelling library;
  6. 3. renders the model from the same angles as your photos and puts them side by side;
  7. 4. corrects the script until the renders match, then makes the final renders;
  8. 5. delivers GLB, OBJ and `.blend` files, and for 3D printing one checked STL per printable part.
  9. The model is an interpretation of the photos, not a measurement: Claude lists every assumption and tells you
  10. which measurement would make it exact.
  11. ![SMARTDEVIL desk fan: photos (top) and the model (bottom)](gallery/smartdevil-fan/comparison.png)
  12. ## Gallery
  13. | model | from | what it shows |
  14. |---|---|---|
  15. | [water-bottle](gallery/water-bottle) | 1 photo | clear plastic, water, a printed label, a strap |
  16. | [smartdevil-fan](gallery/smartdevil-fan) | 5 photos | 4 printable STL parts with fits; [timing](gallery/smartdevil-fan/timing.log): 39 min in all, STLs ready after 14 |
  17. | [calculator-ceiling-mount](gallery/calculator-ceiling-mount) | 5 photos | a functional part designed around an object: a ceiling mount for a calculator, with fit checks |
  18. ![Calculator ceiling mount, installed](gallery/calculator-ceiling-mount/installed_from_below.png)
  19. Each gallery folder has the photos, the `build.py` Claude wrote, its notes, the comparison sheet and the outputs.
  20. Rebuild any of them with `$M build gallery/NAME` (see Use for `$M`).
  21. ## Requirements
  22. - [Claude Code](https://claude.com/claude-code)
  23. - Blender on `PATH` (tested with Blender 5.0.1 on Ubuntu; renders use Cycles on the CPU)
  24. - A system Python of the same version as Blender's (the installer reads it; Ubuntu's Blender 5.0 package runs
  25. Python 3.14), with `venv`: Blender borrows numpy (for the glTF exporter) and Pillow from an environment the
  26. installer makes. Builds from blender.org bundle their own Python, which this setup has not been tested with.
  27. - The DejaVu Sans font (`fonts-dejavu-core` on Debian and Ubuntu), for the comparison sheets and for text on
  28. models; set `PHOTO3D_FONT` to its path if it is somewhere unusual
  29. ## Install
  30. ```bash
  31. git clone https://github.com/lordnukem/photo-to-3d.git
  32. cd photo-to-3d
  33. ./install.sh # links the skill into ~/.claude/skills, makes ~/photo-to-3d/.venv, runs a check
  34. ```
  35. To keep models and the environment somewhere other than `~/photo-to-3d`, run `PHOTO3D_HOME=/path ./install.sh` and
  36. export `PHOTO3D_HOME` in your shell profile.
  37. ## Use
  38. In Claude Code, attach photos and ask, for example: "Model this water bottle", or "Render this desk fan for
  39. 3D printing". Claude follows [`skill/photo-to-3d/SKILL.md`](skill/photo-to-3d/SKILL.md).
  40. The command it uses can also be run by hand:
  41. ```bash
  42. M=~/.claude/skills/photo-to-3d/scripts/model3d
  43. $M check # Blender, numpy, Pillow, font
  44. $M new mug --photo mug.jpg --notes "9.5 cm tall" # ~/photo-to-3d/models/mug with a build.py template
  45. $M build ~/photo-to-3d/models/mug [--clay] # preview renders + comparison sheet (~30 s per view)
  46. $M build ~/photo-to-3d/models/mug --final # final renders (~10 min per view on a 2-core CPU)
  47. ```
  48. A build writes `out/NAME.glb`, `.obj`, `.blend`, `model_info.json` (sizes, parts, problems, assumptions), the
  49. renders and `out/comparison-<quality>.png`. If `build.py` defines `PRINT_PARTS`, it also writes
  50. `out/print/<part>.stl` in millimetres, each part merged into one solid and checked for open edges.
  51. ## What's inside
  52. | path | what |
  53. |---|---|
  54. | `skill/photo-to-3d/SKILL.md` | the workflow Claude follows, the library reference and the pitfalls found in testing |
  55. | `skill/photo-to-3d/scripts/p3d_blender.py` | the modelling library: lathe, extrude, tube, ribbon, rounded boxes, booleans, decals and text, materials from photo colours, cameras, lights, STL export |
  56. | `skill/photo-to-3d/scripts/blender_runner.py` | builds, checks, exports and renders one model inside Blender |
  57. | `skill/photo-to-3d/scripts/model3d.py` | the `model3d` command and the comparison sheets |
  58. | `skill/photo-to-3d/templates/`, `skill/photo-to-3d/examples/` | starting points for a new model |
  59. ## Good at, poor at
  60. Good at manufactured objects: bottles, cups, boxes, gadgets, furniture, tools, packaging, simple parts,
  61. including glass, clear plastic and water. Poor at organic forms (faces, animals, plants, clothing).
  62. ## License
  63. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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