-d97757.svg?style=flat-square){kind=icon}
-f5792a.svg?style=flat-square){kind=icon}
-181717.svg?style=flat-square&logo=github){kind=icon}
-FF8C00.svg?style=flat-square){kind=icon}
-4285F4.svg?style=flat-square){kind=icon}
-ef4444.svg?style=flat-square){kind=icon}
Important
This README is a quick skim. Full documentation lives in docs/README.md — bookmark that page for everything (specs, runtime, install, evals, laws, skills, recipes, research).
- A portable AI-agent Skills pack for Blender, built for users who don't know Blender.
- A content layer (
SKILL.md-based) that loads inside any compatible AI agent. - Complements Anthropic Blender Connector + Blender Lab MCP — does not replace them.
Human intent (non-Blender user)
→ BlendOps Skills (planning · readiness · evidence · handoff)
→ external Blender runtime (Path 1 Lab MCP / Path 2 community / CLI)
→ validated artifacts + non-Blender-user response| BlendOps publishes (this repo's deliverable) | BlendOps redirects to (upstream — not this repo's work) |
|---|---|
| 48 skills (baseline + web 3D deep + quality validators + domain planners + process discipline + asset/sourcing + color/format/output + recipe/pack ops + runtime path discipline, …) | Path 1 — Blender Lab MCP (Lab add-on + Lab server). Owner: Blender Foundation. Source: blender.org/lab/mcp-server |
| 4 laws (evidence-before-done, official-runtime-only, no-arbitrary-python-interface, non-blender-user-language) | Path 1 host (a) — Anthropic Blender Connector (Claude-Desktop-specific MCP host). Owner: Anthropic. Source: claude.com/.../using-the-blender-connector-in-claude |
1 pack (product-hero-v0), 3 bundles (skill-package, claude-desktop-manual, generic-project-local) |
Path 2 — Community ahujasid/blender-mcp (different add-on/server). Owner: 21K+ stars community project. Source: github.com/ahujasid/blender-mcp |
| 26 install target docs + 3 mode auto-detect install flow | CLI fallback (blender --background --python ...). Owner: Blender Foundation. Source: docs.blender.org/manual/.../command_line |
Skill ZIP / OpenAI YAML / canonical bundle generation (npm run skills:export → 48 ZIPs, one per skills/*/SKILL.md) |
The Blender executable, MCP servers, MCP host clients, OS, GPU drivers, network. |
What this means for "completeness":
- The skills layer (48 skills = 3× baseline + workflows + install docs + ZIP generation + CI guards) is complete at Draft v0 — nothing upstream blocks it. Milestones: tag
v0.4.0-draft@ 40 skills, tagv0.5.0-draft@ 48 skills (full roadmap). - Whether the upstream runtime paths work in your environment is up to upstream Blender Foundation / Anthropic /
ahujasid(Path 1 + Path 2 are user-reported verified by the repo owner; CLI is decades-stable upstream). BlendOps redirects to them via per-target install docs but does not own their stability. - The "Full runtime eval: Not Run" / "Artifacts: Not Produced" labels refer to in-repo provenance evidence files only — operator-side records under
docs/evals/. They do not mean "the upstream runtime paths don't work" or "BlendOps is incomplete."
Paste this into any AI agent:
Read and follow the BlendOps AI Agent Quickstart:
https://raw.githubusercontent.com/ThanhNguyxnOrg/blendops/main/docs/ai-agent-quickstart.md
Auto-detect your environment first, then pick one mode:
- If you have project filesystem write access → Mode A: install BlendOps project-locally (skills/, laws/, packs/, target-specific entrypoint).
- If you are in a chat-only UI (Claude Desktop chat, Claude.ai, ChatGPT) with no filesystem write → Mode B: output 48 separate ZIPs from skills/*/SKILL.md (one ZIP per skill) for me to drag-drop into the Skills UI manually.
- If you cannot fetch the repo, cannot write, AND cannot output ZIPs → Mode C: ask one concise question.
Do not install Blender, configure runtime connectors, run Blender, or claim generated artifacts. Report the selected mode, files changed or ZIP filenames, runtime status, artifact status, and limitations.The agent auto-detects which mode applies. Coding agents (Claude Code, Cursor, Codex, OpenCode, Cline, Roo Code, Blackbox AI, Continue, Zed, Windsurf, Trae, Augment Code, goose, OpenHands, JetBrains Junie, Sourcegraph Cody, Aider, Amazon Q Developer, Gemini, Copilot, Antigravity) hit Mode A and install project-locally. Claude Desktop / Claude.ai / ChatGPT chats hit Mode B and output separate ZIPs from skills/*/SKILL.md (one per skill, 48 total) for you to drag-drop into the Skills UI manually. Anything else falls back to Mode C — blocked-needs-input. Full mode logic in docs/ai-agent-install-flow.md.
BlendOps recognizes 2 MCP execution paths + a CLI fallback appendix (full doc):
- Path 1 — Official Blender Lab MCP (Lab add-on + Lab server installed in Blender 5.1+, hosted from either (a) Anthropic Blender Connector in Claude Desktop, or (b) any other MCP client configured manually).
- Path 2 — Community
ahujasid/blender-mcp(different add-on/server, mature 21K+ stars third-party, Blender 3.0+). - CLI fallback (appendix) — direct
blender --background --python. Documented upstream as a first-class Blender CLI surface (stable across LTS releases); no in-repo evidence file yet.
Warning
Anthropic Connector is not standalone. Anthropic's tutorial step 2 explicitly tells you to install the Blender Lab MCP add-on inside Blender. The Connector is the Claude-Desktop-specific MCP host on top of the Lab stack. Path 1 needs Blender 5.1+ regardless of host because of the Lab add-on manifest.
| Want to | Open |
|---|---|
| Read everything (the hub) | docs/README.md |
| 5-minute orientation | docs/start-here.md |
| Set up Blender runtime | docs/external-runtime-setup.md |
| Install BlendOps in your AI tool | docs/install/README.md |
| Browse skills / laws / packs | skills/README.md · laws/README.md · packs/README.md |
| Check release readiness | docs/release-readiness.md |
| See the canonical portable skill package | bundles/skill-package/blendops/ |
BlendOps does not install Blender, ship its own runtime, configure Anthropic Connector or the Lab MCP add-on for you, run Blender, claim mutation/render/export artifacts, ship an npx installer, or claim a marketplace listing. See docs/release-readiness.md for the honest current state.
MIT — see LICENSE.