Modly CLI
Calls a running Modly app from the terminal to make image-to-3D assets.
Install
npx skills add lightningpixel/modly --skill modly-cli -g -a claude-code -y- Repository
- lightningpixel/modly8.5k
- Category
- Media
- Updated
- 3d ago
- License
- MIT
- Context cost
- Mediumabout 1,652 tokens
- Runs scripts
- Yes, review before use
What it does
Use when an agent needs to call a running Modly desktop instance from the terminal to generate/export image-to-3D assets through canonical JSON-first automation commands.
Modly CLI
Overview
Modly exposes a local API at http://127.0.0.1:8765 while the official desktop app is running. The stdlib-only CLI at tools/modly-cli/agent.py is an agent helper over the canonical automation contract:
healthmodelworkflow-runcapabilityprocess-run
Final machine-readable JSON is printed to stdout. Progress JSON lines, when requested, are printed to stderr.
Prerequisites
Launch the official Modly desktop app first, then check readiness:
python tools/modly-cli/agent.py health
Use --compact when another agent needs single-line JSON:
python tools/modly-cli/agent.py --compact health
GET /health is checked before business operations. If the app is unavailable, failures are structured:
{
"ok": false,
"code": "API_UNAVAILABLE",
"message": "Cannot reach Modly API at ..."
}
Canonical Commands
Inspect models through /model/*:
python tools/modly-cli/agent.py model list
python tools/modly-cli/agent.py model status
python tools/modly-cli/agent.py model params --model active
Start or resume workflow runs:
python tools/modly-cli/agent.py workflow-run start --image ./input.png --wait
python tools/modly-cli/agent.py workflow-run status <run_id>
python tools/modly-cli/agent.py workflow-run cancel <run_id>
Generate from an image and export the finished mesh:
python tools/modly-cli/agent.py generate \
--image ./input.png \
--output ./export.glb \
--progress
generate is a friendly wrapper around POST /workflow-runs/from-image and GET /workflow-runs/{run_id}. It does not silently fall back to /generate/*. The JSON includes recovery metadata:
