Skip to content

elithril/blender-kiln / plugin

Makes and fixes 3D assets in Blender, for games, the web and AR. Use when the user wants a 3D model, prop, character or GLB/glTF/FBX/USDZ file made — from a text brief, a reference image, a free marketplace (PolyHaven, Sketchfab) or AI generation — AND when they bring an existing 3D file to fix: too heavy or too many polygons (optimize, compress, LODs), broken normals, scale or origin, materials lost on glTF export, conversion between GLB, FBX and USDZ, texturing, rigging for animation, animating it (walk and idle cycles, text-to-motion, looping clips, articulated props), or inspection. Drives Blender through a Blender MCP server (ahujasid's or the official Blender Lab one). Batch mode produces many consistent assets unattended. Kiln Studio (`/kiln studio`) opens the project's models in the browser, where the user reviews them and pins notes for Claude to act on.

FileKindSize
.claude-plugin/plugin.jsonconfig1.2 KB
.mcp.jsonconfig236 B
LICENSEother1.0 KB
NOTICEother2.5 KB
SKILL.mdskill md29.0 KB
references/ai-generation.mdmarkdown21.0 KB
references/animation.mdmarkdown21.6 KB
references/batch-mode.mdmarkdown19.5 KB
references/blender-mcp.mdmarkdown9.4 KB
references/characters.mdmarkdown52.8 KB
references/cli-tools.mdmarkdown6.5 KB
references/commands.mdmarkdown10.7 KB
references/export-targets.mdmarkdown14.3 KB
references/log-format.mdmarkdown2.2 KB
references/naming-conventions.mdmarkdown5.8 KB
references/photo-projection.mdmarkdown6.3 KB
references/pipeline-brief.mdmarkdown4.2 KB
references/pipeline-import-cleanup.mdmarkdown6.3 KB
references/pipeline-optimize-export.mdmarkdown6.4 KB
references/pipeline-rig-animate.mdmarkdown5.8 KB
references/pipeline-source.mdmarkdown9.7 KB
references/print.mdmarkdown41.5 KB
references/reference-fidelity.mdmarkdown31.8 KB
references/review-rounds.mdmarkdown10.4 KB
references/setup-install.mdmarkdown2.8 KB
references/setup.mdmarkdown9.2 KB
references/sourcing-strategy.mdmarkdown6.1 KB
references/studio.mdmarkdown38.9 KB
references/texturing-strategy.mdmarkdown14.4 KB
references/topology-rules.mdmarkdown3.9 KB
references/uv-materials.mdmarkdown6.8 KB
references/validation-checklist.mdmarkdown10.5 KB
studio/approval_hook.pyscript14.2 KB
studio/blender_live.pyscript2.3 KB
studio/checks.pyscript38.1 KB
studio/estimate.pyscript4.2 KB
studio/example/barrel/barrel_final.glbbinary111.9 KB
studio/example/barrel/barrel_log.mdmarkdown445 B
studio/handoff.pyscript17.8 KB
studio/mcp_server.pyscript32.7 KB
studio/phoneshare.pyscript17.1 KB
studio/server.pyscript47.9 KB
studio/setup_status.pyscript7.5 KB
studio/static/app.jsscript241.4 KB
studio/static/apple-touch-icon.pngbinary20.6 KB
studio/static/fonts/OFL-JetBrainsMono.txtmarkdown4.3 KB
studio/static/fonts/OFL-Sora.txtmarkdown4.3 KB
studio/static/fonts/jetbrains-mono-latin-ext.woff2binary11.3 KB
studio/static/fonts/jetbrains-mono-latin.woff2binary30.6 KB
studio/static/fonts/sora-latin-ext.woff2binary11.8 KB
studio/static/fonts/sora-latin.woff2binary24.6 KB
studio/static/i18n.jsscript6.2 KB
studio/static/i18n/fr.jsonconfig101.2 KB
studio/static/icon-32.pngbinary2.6 KB
studio/static/icon-64.pngbinary6.6 KB
studio/static/icon-96.pngbinary12.8 KB
studio/static/index.htmlother39.5 KB
studio/static/style.cssother114.5 KB
studio/static/tutorial.jsscript49.0 KB
studio/static/tutorial/barrel_after.glbbinary117.3 KB
studio/static/tutorial/barrel_before.glbbinary111.9 KB
studio/static/tutorial/fixtures.jsonconfig13.5 KB
studio/static/tutorial/lantern_1_blockout.glbbinary83.1 KB
studio/static/tutorial/lantern_2_details.glbbinary101.8 KB
studio/static/tutorial/lantern_3_materials.glbbinary102.0 KB
studio/static/tutorial/lantern_4_final.glbbinary141.1 KB
studio/static/tutorial/make_tutorial.pyscript4.9 KB
studio/static/viewer.jsscript41.4 KB
studio/studio.pyscript29.2 KB
studio/studiolib.pyscript77.8 KB
studio/test_studio.pyscript90.2 KB
studio/test_worker.pyscript31.5 KB
studio/worker.pyscript56.8 KB
studio/worker_blender.pyscript2.7 KB
tools/autorig.pyscript44.1 KB
tools/bind_rigid_parts.pyscript3.6 KB
tools/blender_mcp_start.pyscript1.5 KB
tools/check_usdz.pyscript1004 B
tools/cutout.swiftscript2.0 KB
tools/export_outputs.pyscript5.2 KB
tools/fidelity_check.pyscript39.0 KB
tools/fit_coupon.pyscript11.3 KB
tools/fixtures/skintokens_raw_child.glbbinary88.8 KB
tools/fixtures/skintokens_skeletons.jsonconfig6.5 KB
tools/flatten.pyscript14.9 KB
tools/glb_to_fbx.pyscript2.1 KB
tools/glb_to_usdz.pyscript6.2 KB
tools/motion_loop.pyscript5.9 KB
tools/motion_measure.pyscript15.2 KB
tools/motions/LICENSE-image-to-3dlab.txtmarkdown11.1 KB
tools/motions/cheer.npzbinary48.4 KB
tools/motions/cheer_b.npzbinary48.1 KB
tools/motions/dance.npzbinary78.2 KB
tools/motions/dance_b.npzbinary78.9 KB
tools/motions/death.npzbinary45.9 KB
tools/motions/death_b.npzbinary46.5 KB
tools/motions/fight_stance.npzbinary60.3 KB
tools/motions/fight_stance_b.npzbinary61.3 KB
tools/motions/flying_kick.npzbinary39.7 KB
tools/motions/flying_kick_b.npzbinary39.9 KB
tools/motions/hit_react.npzbinary31.9 KB
tools/motions/hit_react_b.npzbinary31.8 KB
tools/motions/idle.npzbinary51.8 KB
tools/motions/idle_b.npzbinary57.7 KB
tools/motions/jump.npzbinary39.8 KB
tools/motions/jump_b.npzbinary39.9 KB
tools/motions/kata.npzbinary77.4 KB
tools/motions/kata_b.npzbinary75.3 KB
tools/motions/kick.npzbinary32.4 KB
tools/motions/kick_b.npzbinary32.5 KB
tools/motions/presets.jsonconfig9.6 KB
tools/motions/punch.npzbinary32.0 KB
tools/motions/punch_b.npzbinary32.1 KB
tools/motions/punch_combo.npzbinary47.4 KB
tools/motions/punch_combo_b.npzbinary47.5 KB
tools/motions/roll.npzbinary46.7 KB
tools/motions/roll_b.npzbinary47.5 KB
tools/motions/roundhouse.npzbinary39.7 KB
tools/motions/roundhouse_b.npzbinary39.9 KB
tools/motions/run.npzbinary47.2 KB
tools/motions/run_b.npzbinary47.7 KB
tools/motions/sit.npzbinary47.2 KB
tools/motions/sit_b.npzbinary47.2 KB
tools/motions/sneak.npzbinary61.6 KB
tools/motions/sneak_b.npzbinary61.8 KB
tools/motions/strafe_left.npzbinary45.9 KB
tools/motions/strafe_left_b.npzbinary47.1 KB
tools/motions/sword_swing.npzbinary39.7 KB
tools/motions/sword_swing_b.npzbinary39.4 KB
tools/motions/walk.npzbinary62.8 KB
tools/motions/walk_b.npzbinary62.6 KB
tools/motions/walk_woman.npzbinary62.9 KB
tools/motions/wave.npzbinary46.3 KB
tools/motions/wave_b.npzbinary46.3 KB
tools/open_blender.pyscript5.0 KB
tools/photo_project.pyscript37.8 KB
tools/presets.pyscript16.3 KB
tools/print_check.pyscript47.2 KB
tools/quadruped.pyscript19.4 KB
tools/retarget.pyscript46.9 KB
tools/review_renders.pyscript13.8 KB
tools/review_sheet.pyscript11.0 KB
tools/skintokens-requirements.txtmarkdown2.4 KB
tools/skintokens.patchother9.2 KB
tools/template_profile.pyscript5.8 KB
tools/test_autorig.pyscript15.9 KB
tools/test_fidelity_check.pyscript20.7 KB
tools/test_fit_coupon.pyscript6.4 KB
tools/test_flatten.pyscript15.0 KB
tools/test_open_blender.pyscript1.3 KB
tools/test_photo_project.pyscript12.6 KB
tools/test_presets.pyscript17.6 KB
tools/test_print_check.pyscript33.1 KB
tools/test_review_renders.pyscript11.4 KB
tools/test_review_sheet.pyscript4.0 KB
tools/test_template_profile.pyscript3.6 KB
tools/test_uv_check.pyscript5.0 KB
tools/test_verify_docs.pyexecutablescript7.9 KB
tools/unimate.patchother3.5 KB
tools/unimate.pyscript17.5 KB
tools/uv_check.pyscript8.4 KB
tools/verify_blender.pyexecutablescript29.2 KB
tools/verify_docs.pyexecutablescript16.6 KB

studio/setup_status.py

View on GitHub
"""What Studio can tell about the kiln setup on this machine, for its welcome screen.

Standard library only. Each probe says what it found and how: "ok", "missing", or
"unknown" when Studio cannot see it from here, never a guess (references/setup.md § /kiln setup is
the full scan, run by Claude). Results are cached a minute: the probes run programs.
"""

from __future__ import annotations

import glob
import json
import os
import platform
import shutil
import socket
import subprocess
import sys
import time
from pathlib import Path

HERE = Path(__file__).resolve().parent
PLUGIN = HERE.parent
MCP_PORT = 9876   # the Blender MCP add-on's socket (ahujasid's; references/setup-install.md)
_cache: dict = {}


def _row(key: str, state: str, detail: str, how: str, **data) -> dict:
    """`detail` in English for API readers; `data`, the same facts for the page to word."""
    return {"key": key, "state": state, "detail": detail, "how": how, "data": data}


def blender_paths() -> list[str]:
    found = []
    for env in ("KILN_BLENDER", "BLENDER"):
        if os.environ.get(env):
            found.append(os.environ[env])
    if shutil.which("blender"):
        found.append(shutil.which("blender"))
    system = platform.system()
    if system == "Darwin":
        found += ["/Applications/Blender.app/Contents/MacOS/Blender",
                  str(Path.home() / "Applications/Blender.app/Contents/MacOS/Blender")]
    elif system == "Windows":
        found += sorted(glob.glob(r"C:\Program Files\Blender Foundation\Blender*\blender.exe"), reverse=True)
    else:
        found += ["/usr/bin/blender", "/snap/bin/blender", "/usr/local/bin/blender"]
    out = []
    for p in found:
        if p and Path(p).is_file() and p not in out:
            out.append(p)
    return out


def blender() -> dict:
    paths = blender_paths()
    how = "PATH, $BLENDER, and the usual install folders"
    if not paths:
        return _row("blender", "missing", "", how)
    try:
        r = subprocess.run([paths[0], "--version"], capture_output=True, text=True, timeout=20)
        first = next((ln.strip() for ln in r.stdout.splitlines() if ln.startswith("Blender")), "")
    except (OSError, subprocess.TimeoutExpired):
        first = ""
    return _row("blender", "ok", f"{first or 'Blender'} · {paths[0]}", how, version=first, path=paths[0])


def _claude_mcp_names(project_root: Path) -> set[str]:
    """The MCP servers Claude Code is configured with for this project (names only)."""
    names: set[str] = set()
    for p in (project_root / ".mcp.json", Path.home() / ".claude.json"):
        try:
            data = json.loads(p.read_text())
        except (OSError, ValueError):
            continue
        if not isinstance(data, dict):
            continue
        names |= set((data.get("mcpServers") or {}).keys())
        proj = (data.get("projects") or {}).get(str(project_root)) or {}
        names |= set((proj.get("mcpServers") or {}).keys()) if isinstance(proj, dict) else set()
    return names


def blender_mcp(project_root: Path) -> dict:
    """Studio cannot see Claude's connections: always "unknown", with what it can see."""
    names = _claude_mcp_names(project_root)
    configured = sorted(n for n in names if "blender" in n.lower())
    try:
        with socket.create_connection(("127.0.0.1", MCP_PORT), timeout=0.3):
            listening = True
    except OSError:
        listening = False
    bits = [f"configured: {', '.join(configured)}" if configured else "no Blender MCP server in Claude Code's settings for this project",
            f"add-on port {MCP_PORT}: {'open' if listening else 'closed'}"]
    return _row("mcp", "unknown", " · ".join(bits),
                "Claude Code's settings and a connection to the add-on's port; whether Claude is connected only Claude can say",
                configured=configured, port=MCP_PORT, listening=listening)


def skintokens() -> dict:
    tool = PLUGIN / "tools" / "autorig.py"
    how = "tools/autorig.py status --quick"
    if not tool.is_file():
        return _row("skintokens", "unknown", "this kiln has no tools/autorig.py", how, reason="no-tool")
    try:
        r = subprocess.run([sys.executable, str(tool), "status", "--quick"], capture_output=True, text=True, timeout=30)
    except (OSError, subprocess.TimeoutExpired) as e:
        return _row("skintokens", "unknown", str(e), how, reason="error", output=str(e))
    detail = (r.stdout or r.stderr).strip().splitlines()[-1:] or [""]
    state = {0: "ok", 2: "missing", 3: "missing"}.get(r.returncode, "unknown")
    return _row("skintokens", state, detail[0], how, reason=f"exit {r.returncode}", output=detail[0])


def claude_code() -> dict:
    how = "claude --version"
    exe = shutil.which("claude")
    if not exe:
        return _row("claude", "missing", "Claude Code is not on PATH", how)
    try:
        r = subprocess.run([exe, "--version"], capture_output=True, text=True, timeout=10)
        version = (r.stdout or "").strip().split()[0] if r.returncode == 0 and r.stdout.strip() else None
    except (OSError, subprocess.TimeoutExpired):
        version = None
    return _row("claude", "ok", f"Claude Code {version or ''} · {exe}".strip(), how, version=version, path=exe)


def optimizers() -> dict:
    """gltf-transform and gltfpack: kiln's OPTIMIZE phase compresses with them when present."""
    found = {n: shutil.which(n) for n in ("gltf-transform", "gltfpack")}
    have = [n for n, x in found.items() if x]
    state = "ok" if len(have) == 2 else "missing" if not have else "partial"
    return _row("optimizers", state, ", ".join(have) or "neither", "command -v gltf-transform gltfpack", found=have)


def unimate() -> dict:
    """UniMate (text to motion): installed when its venv is there (tools/unimate.py setup)."""
    home = Path(os.environ.get("UNIMATE_HOME") or "~/.cache/blender-kiln/unimate").expanduser()
    venv = home / "venv" / "bin" / "python"
    tool = PLUGIN / "tools" / "unimate.py"
    if not tool.is_file():
        return _row("unimate", "unknown", "this kiln has no tools/unimate.py", "tools/unimate.py status", reason="no-tool")
    return _row("unimate", "ok" if venv.is_file() else "missing", str(home), "tools/unimate.py status", home=str(home))


# What each part is for, how much it matters, what it weighs and under which licence: the
# page shows these beside the state, and Install with Claude runs /kiln setup <key>.
COMPONENTS = {
    "blender": {"need": "required", "size": "≈ 1 GB", "licence": "GPL", "install": True},
    "claude": {"need": "required", "size": "≈ 200 MB", "licence": "Anthropic", "install": False},
    "mcp": {"need": "required", "size": "", "licence": "MIT", "install": False},
    "optimizers": {"need": "recommended", "size": "≈ 60 MB", "licence": "MIT", "install": True},
    "skintokens": {"need": "optional", "size": "≈ 2 GB", "licence": "MIT", "install": True},
    "unimate": {"need": "optional", "size": "≈ 3.2 GB", "licence": "CC BY-NC 4.0 (non-commercial)", "install": True},
}


def install_status(project_root: Path, max_age: float = 60.0) -> dict:
    key = str(project_root)
    hit = _cache.get(key)
    if hit and time.monotonic() - hit[0] < max_age:
        return hit[1]
    manifest = {}
    try:
        manifest = json.loads((PLUGIN / ".claude-plugin" / "plugin.json").read_text())
    except (OSError, ValueError):
        pass
    rows = [blender(), claude_code(), blender_mcp(project_root), optimizers(), skintokens(), unimate()]
    for r in rows:
        r.update(COMPONENTS.get(r["key"], {}))
    out = {"kiln": manifest.get("version"), "rows": rows}
    _cache[key] = (time.monotonic(), out)
    return out
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall