Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
Turn one image of anything into a 3D sculpt measured against that image: registered views, map-fitting passes, Blender replay and timelapse. A skill for coding agents.
Saved setup from 2 h ago
Will it work on macOS?
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/gokayfem/image-to-sculpt.git cd image-to-sculpt
Python 3.12, Node.js
brew install python@3.12 brew install node
python -m venv .venv source .venv/bin/activate pip install -r requirements.txt
Claude Code (plugin marketplace):
claude plugin marketplace add gokayfem/image-to-sculpt
claude plugin install image-to-sculpt@image-to-sculpt
Or copy the skill: cp -R skills/image-to-sculpt ~/.claude/skills/.
Codex, Cursor, Gemini CLI, Copilot and other agents (via skills):
npx skills add gokayfem/image-to-sculpt
Or install by hand:
skills/image-to-sculpt to ~/.agents/skills/.~/.cursor/skills/, plus the rule in adapters/cursor/.gh skill install gokayfem/image-to-sculpt image-to-sculpt, plus adapters/copilot/.gemini extensions install https://github.com/gokayfem/image-to-sculpt.claude.ai: zip skills/image-to-sculpt and upload it under Settings > Capabilities > Skills.
ChatGPT, Gemini Gems and other chat tools: see adapters/.
Requirements: Python 3.10+ with numpy, scipy, scikit-image and Pillow (pip install -r requirements.txt
adds fal-client and matplotlib), Blender 5.2+ ($BLENDER, blender on PATH, or the macOS app) and ffmpeg
for the replay and films, and a fal API key in FAL_KEY for masks, depth, normals and generated views.
python3 skills/image-to-sculpt/scripts/i2s.py doctor checks all of it (the key is never printed).
No reports for macOS yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.