CLI

thrixel makes 3D models from a terminal. One command takes a description to a finished model on disk, and every tool the MCP server gives an agent is one thrixel run away. It ships in the same package as the MCP server and shares its sign-in.

thrixel make "a mossy stone frog statue, squat, cracked grey stone" -o frog.glb

Install

Requires uv.

uv tool install thrixel-mcp

Sign in

thrixel login

This prints a link and a short code. Open the link, check that the code matches, and approve. It works on a machine with no browser: open the link on your phone. You can create an account on the same page.

The key is saved in ~/.thrixel/credentials.json and does not expire. thrixel status shows which key is in use and thrixel logout removes it. In CI, set THRIXEL_API_KEY instead; it takes precedence over the saved key. Create one at thrixel.com/create.

Quick start

thrixel balance                                   # Cubes, plan, running jobs
thrixel make "a red oil barrel" --dry-run         # steps and cost, nothing submitted
thrixel make "a red oil barrel" --tris 2000 -o barrel.glb
thrixel tools                                     # everything else you can run

make

Make a 3D model from a description or an image, and save it.

thrixel make [PROMPT] [options]

Waits for every step, shows progress, and saves only the final file. The default engine, sculpt, returns one textured, high-detail mesh: the right choice for creatures, characters, plants, rocks and props that do not move. When parts must move on their own (wheels, doors, turrets, limbs), use --engine create, which keeps each part as a separate named node.

Examples:

# A textured prop from a photo
thrixel make -i photo.jpg -o lamp.glb
 
# A cart with wheels that can turn, detailed, for Unity
thrixel make "a wooden farm cart with two spoked wheels" \
  --engine create --detail --format fbx --target unity -o cart.fbx
 
# A light, small model for a browser game
thrixel make "a treasure chest" --tris 3000 --webp -o public/models/chest.glb

What a run costs:

$ thrixel make "a mossy stone frog statue" --tris 5000 --format fbx --target unity --dry-run
Plan (nothing submitted):
  sculpt   Sculpt a textured single-piece model - 11 cubes
  reduce   Reduce to at most 5,000 triangles - free
  convert  Convert to FBX for unity - free
Estimate: 11 cubes
Balance:  518 cubes

On the Free plan the dry run also says how many runs of each step are left this month, and warns when one is used up.

create is metered on actual usage, so its estimate is a range.

Other commands

Click a command for its options and examples.

Scripting

Progress goes to stderr and the result to stdout, so path=$(thrixel make ...) captures the saved file. With --json, stdout is a single object:

{"ok": true, "file": "/work/frog.glb", "bytes": 880572,
 "submission_id": "50d876b9-...",
 "steps": [{"op": "sculpt", "submission_id": "...", "seconds": 64},
           {"op": "reduce", "submission_id": "50d876b9-...", "seconds": 17}]}

A failure is {"ok": false, "error": "...", "exit_code": 4}.

Exit codes

Configuration

Environment variables

Files