blender-agent-studio
Codex plugin for reproducible Blender modeling, validation, animation, MCP tooling, and agent benchmarking
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ifBars/blender-agent-studio with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ifBars/blender-agent-studio'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/ifbars--blender-agent-studio)HTML
<a href="/listings/ifbars--blender-agent-studio"><img src="/api/listings/ifbars--blender-agent-studio/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
You'll need [Codex](https://developers.openai.com/codex) or [Claude Code](https://code.claude.com) with plugin support, [Bun](https://bun.sh), and Blender. Blender 5.2 LTS is the tested version; use Bun 1.3.5 or newer. Both hosts install the same skills, MCP server, and SceneIR tools from this repository.
**Codex**
codex plugin marketplace add ifBars/blender-agent-studio codex plugin add blender-agent-studio@blender-agent-studio
**Claude Code**
claude plugin marketplace add ifBars/blender-agent-studio claude plugin install blender-agent-studio@blender-agent-studio
Inside a Claude Code session, `/plugin marketplace add ifBars/blender-agent-studio` and `/plugin install blender-agent-studio@blender-agent-studio` do the same.
Put `blender` on your `PATH`, or set `BLENDER_EXECUTABLE` to its location. For example, in PowerShell:
$env:BLENDER_EXECUTABLE = "C:\path\to\Blender\blender.exe"
Start a new Codex task or Claude Code session after installing or updating the plugin. In Codex, invoke a skill as `$blender-agent-studio:blender-modeling-workflow`; in Claude Code, as `/blender-agent-studio:blender-modeling-workflow`. Both hosts also pick the relevant skill from a plain request.
For the optional scene-understanding tools, build the Rust runtime in the installed plugin directory with `bun run setup:runtime`. See [scene understanding](docs/scene-understanding.md) for setup, examples and measurement limits. The existing tools do not require Rust.
<details> <summary>Update an existing GitHub installation</summary>
Codex:
codex plugin marketplace upgrade blender-agent-studio codex plugin add blender-agent-studio@blender-agent-studio
Claude Code:
claude plugin marketplace update blender-agent-studio claude plugin update blender-agent-studio@blender-agent-studio
</details>
Prefer skills only? See the [alternative installation options](docs/development.md#skills-only-installation) and [browse the workflows on skills.sh](https://skills.sh/ifbars/blender-agent-studio).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 15 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "blender-agent-studio",
- "description": "Marketplace for a free, open-source Blender AI plugin. Build with local Blender from the agent you already use.",
- "owner": {
- "name": "Bars"
- },
- "plugins": [
- {
- "name": "blender-agent-studio",
- "source": "./plugins/blender-agent-studio",
- "description": "Free, open-source Blender AI plugin for modeling, animation, rendering, validation, and repair with local Blender. Codex and Claude Code installers.",
- "category": "development"
- }
- ]
- }
README.md · README · 289 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Blender Agent Studio
- **Describe a model, scene or animation to Codex or Claude Code. Get back an
- editable `.blend`, the Python that built it, and renders your agent has checked.**
- A free, open-source Blender AI plugin. It runs your local Blender and needs no
- extra service, API key or subscription beyond the agent you already use.
- [](https://github.com/ifBars/blender-agent-studio/actions/workflows/validate.yml)
- [](LICENSE)
- [](https://ifbars.github.io/blender-agent-studio/)
- [Docs](https://ifbars.github.io/blender-agent-studio/) · [Quick start](#quick-start) · [Examples](https://ifbars.github.io/blender-agent-studio/comparisons/) · [How it works](#how-it-works) · [Workflows](plugins/blender-agent-studio/skills) · [Development](docs/development.md) · [Report a bug](https://github.com/ifBars/blender-agent-studio/issues)
- [](https://ifbars.github.io/blender-agent-studio/comparisons/)
- A reading room built with Claude Code and Sonnet 5.5, rendered from the saved
- scene. It is one selected result, not an average: the [paired
- examples](https://ifbars.github.io/blender-agent-studio/comparisons/) show runs
- with and without the plugin, including failed checks and mixed visual reviews.
- ## Quick start
- You need [Claude Code](https://code.claude.com) or
- [Codex](https://developers.openai.com/codex), [Blender](https://www.blender.org/download/)
- (5.2 LTS is the tested version) and [Bun](https://bun.sh) 1.3.5 or newer.
- **1. Install the plugin.**
- ```bash
- # Claude Code
- claude plugin marketplace add ifBars/blender-agent-studio
- claude plugin install blender-agent-studio@blender-agent-studio
- # Codex
- codex plugin marketplace add ifBars/blender-agent-studio
- codex plugin add blender-agent-studio@blender-agent-studio
- ```
- **2. Check your setup.** Start a new Claude Code session or Codex task and ask:
- > Check my Blender Agent Studio setup.
- The agent runs `blender_check_setup`. It finds Blender, saves and reopens a tiny
- scene, renders a small preview image, and tells you what to fix if a step fails.
- It never opens your own files. Usually Blender is found
- automatically; if not, see [point it at Blender](#point-it-at-blender).
- **3. Make something.**
- > Use Blender Agent Studio to build a walnut desk lamp. Give it warm lighting,
- > render it from two angles, and save the .blend and Python source.
- You get an editable `.blend`, the Python that built it, and two renders. Open
- the images and judge the lamp yourself: the automated checks catch broken
- geometry and exports, not taste. See [more to try](#more-to-try) for writing
- your own requests.
- ## What you can do
- - View an open Blender session inline, orbit and zoom, and attach a clicked object to your next message with the optional [Studio Live addon](docs/live-viewport.md).
- - Build props, environments, characters, and Geometry Nodes setups.
- - Design readable signs, labels and graphic panels as editable 2D artwork, then integrate their materials and supports and review them at the intended distance. See the [signage workflow](plugins/blender-agent-studio/skills/blender-signage-workflow/SKILL.md).
- - Optionally record real modeling milestones and deliver a timelapse from the empty/default scene to the completed render. Ask before modeling starts; [capture guide](plugins/blender-agent-studio/skills/blender-rendering-workflow/references/modeling-timelapse.md).
- - Gather references from several angles and compare the model's proportions before adding detail.
- - Overlay projected geometry on a reference image, with optional silhouette-mask measurements for missing and excess coverage. See [reference modeling](docs/reference-modeling.md).
- - Rig and animate models, or work with cloth, smoke, and other simulations.
- - Render through your scene's cameras with its lighting intact, or use studio views to inspect a model from every side.
- - Download CC0 textures and HDRIs from Poly Haven at 1K, 2K, 4K, or 8K.
- - Find Mixamo motion through your browser and import downloaded FBX animations into a new `.blend`. See the [Mixamo workflow](plugins/blender-agent-studio/skills/blender-animation-workflow/references/mixamo.md) for browser requirements and retargeting limits.
- - Find and preview Pixabay sound effects through a browser handoff. The tool provides a search URL and workflow; it does not return live results or import audio. See the [MCP integration guide](plugins/blender-agent-studio/skills/blender-mcp-integration/SKILL.md#pixabay-sound-effects-browser-integration).
- - Check geometry and exported files, review renders, and repair what doesn't work.
- - Query scene parts and evaluated dimensions, check explicit geometry and ground constraints, and compare repairs against preserved SceneIR baselines with the optional Rust runtime.
- The plugin includes twelve specialist skills and a local MCP server for
- inspection, rendering, and asset downloads. Generated scenes come with Python
- source so you can rebuild them and keep making changes. Codex and Claude Code
- have bundled installers today; other hosts need compatible skill loading and
- local execution; see [portability and host requirements](https://ifbars.github.io/blender-agent-studio/bring-your-agent/).
- ## How it works
- The skills guide the agent through modeling, rendering, animation, and other
- tasks. Blender runs locally to build or inspect the saved scene; you do not need
- to keep its interface open. The agent chooses the relevant steps for your
- request. The workflows and tools help it:
- - Turn the brief into parts, proportions, finish goals, and delivery checks.
- Review a graybox before spending time on materials and small details.
- - Check geometry, materials, dimensions, and other scene details. For an export,
- it can reopen the file in a fresh Blender process to check what survived.
- - Render a hero view plus fixed front, back, left, right, and top views. During
- repairs, it can use two smaller views for faster feedback before the full check.
- - Light diagnostic views with a studio setup scaled to the asset. The `auto`
- preset picks a contrasting background from simple material color hints; the
- agent still needs to inspect the image and adjust it when the choice fails.
- - Render through the scene's own cameras and lighting for beauty images. The
- tool caps resolution, samples, and render time. It offers faster `preview`
- and higher-quality `final` denoising policies; by default, it preserves the
- scene's authored denoising settings. The agent selects the policy for the job.
- The `.blend` is the editable result. The Python source records the build steps,
- so you can regenerate it or ask the agent to change it later. The [workflow
- guide](SKILL.md#route-the-request) explains which specialist skills apply to
- each kind of task. Studio views are for inspection and do not replace your
- scene's authored lighting in beauty renders.
- ## Install
- The [quick start](#quick-start) has the install commands. Both hosts install
- the same skills, MCP server, and SceneIR tools from this repository. Inside a
- Claude Code session, `/plugin marketplace add ifBars/blender-agent-studio` and
- `/plugin install blender-agent-studio@blender-agent-studio` do the same as the
- terminal commands.
- Start a new task or session after installing or updating the plugin. Both hosts
- pick the relevant skill from a plain request. To name one, use
- `$blender-agent-studio:blender-modeling-workflow` in Codex or
- `/blender-agent-studio:blender-modeling-workflow` in Claude Code.
- ### Point it at Blender
- The plugin uses the first Blender it finds:
- 1. A `blenderPath` given to a tool, or `--blender` on the command line.
- 2. The `BLENDER_EXECUTABLE` environment variable.
- 3. `blender` on your `PATH`.
- 4. Standard install locations: the official installers on macOS
- (`/Applications`) and Windows (`Program Files\Blender Foundation`), Steam,
- and on Linux Snap, Flatpak, and archives unpacked in your home folder or
- `/opt`. When several are installed, it prefers 5.2 LTS.
- A configured path that is wrong is reported, never silently replaced. For any
- other location, set `BLENDER_EXECUTABLE` to the executable itself, not its folder:
- ```powershell
- $env:BLENDER_EXECUTABLE = "C:\path\to\Blender\blender.exe"
- ```
- ```bash
- export BLENDER_EXECUTABLE="/Applications/Blender.app/Contents/MacOS/Blender"
- ```
- Launch your CLI agent from the terminal where you set the variable, or configure
- your desktop host's environment; a new conversation may not inherit shell
- changes. `blender_version` reports which executable was found and how.
- ### Check from a terminal
- The same setup check runs without an agent. From a repository checkout or the
- installed plugin directory:
- ```bash
- bun run doctor
- ```
- It saves and reopens a tiny scene, renders a 128px Cycles preview on CPU, and
- tries a 64px EEVEE render. It needs no API key, GPU, downloads, or Rust, and it
- keeps the `.blend`, previews, logs, and a JSON report in a new temporary folder.
- A failed check exits nonzero. An EEVEE warning means Cycles works but the studio
- inspection views need OpenGL, which headless Linux machines may lack. Use
- `--blender "/path/to/blender"` to override discovery or `--output-dir NEW_DIRECTORY`
- to keep the evidence somewhere specific. See [setup troubleshooting](docs/development.md#setup-troubleshooting)
- if a check fails.
- ### Optional and alternative installs
- For the optional scene-understanding tools, build the Rust runtime in the
- installed plugin directory with `bun run setup:runtime`. See
- [scene understanding](docs/scene-understanding.md) for setup, examples and
- measurement limits. The other tools do not require Rust.
- <details>
- <summary>Update an existing GitHub installation</summary>
- Codex:
- ```bash
- codex plugin marketplace upgrade blender-agent-studio
- codex plugin add blender-agent-studio@blender-agent-studio
- ```
- Claude Code:
- ```bash
- claude plugin marketplace update blender-agent-studio
- claude plugin update blender-agent-studio@blender-agent-studio
- ```
- </details>
- Prefer skills only? See the [alternative installation options](docs/development.md#skills-only-installation)
- and [browse the workflows on skills.sh](https://skills.sh/ifbars/blender-agent-studio).
- ## More to try
- Include the style, dimensions, and intended use when they matter:
- > Build a 30 cm stylized brass lantern for a mobile game. Export a GLB and
- > check that it imports correctly.
- > Here is `desk.blend`. Inspect it from every side, list what looks wrong, and
- > fix the worst problem without changing anything else.
- For a game asset, ask for a GLB export and an import check. For a render, you
- can specify a camera angle, lighting, or reference image. For a second review,
- ask the agent to check the result from multiple views.
- ## How well does it work?
- In five fresh, matched pairs covering a lantern, lever press, and animated
- drawbridge, the plugin's guided workflow passed the technical gate five times;
- the agent without it failed five times. Three blinded visual judges preferred
- the plugin asset in four of the five pairs. On one lantern repeat, all three
- preferred the baseline's appearance even though its geometry failed the
- technical gate. The plugin used more reported tokens. Lantern build time was
- about even across three pairs; the press and drawbridge plugin runs took about
- twice as long. See the [current paired evidence](docs/plugin-quality-evidence.md)
- for scores, controls, and defects.
- These results show a quality gain for delivery checks on the tested prompts,
- with less consistent visual gains. Five pairs cannot give a reliable success
- rate for arbitrary prompts, models, or art styles. The three judges in each
- pair reviewed the same two assets; their votes are not separate generations.
- The comparison used the plugin's skills without its optional MCP tools, so it
- does not measure the extra benefit of those tools. An [earlier four-task
- comparison](plugins/blender-agent-studio/skills/blender-agent-benchmark/references/validated-results.md)
- also favored the plugin's final runs, but a harder integrated task had mixed
- results. Plugin revisions have shown [both gains and
- regressions](docs/quality-development.md). Review the result yourself,
- particularly its shape, materials, animation, and exported files.
- The five pairs above ran in Codex. The [published gallery](https://ifbars.github.io/blender-agent-studio/comparisons/)
- now retains 31 pairs, including later scene comparisons with Sonnet 5.5 and
- Opus 5.5 in Claude Code, alongside the Codex models. The [scene report](docs/scene-comparison-2026-10-04.md)
- records their controls, scores, visual votes, and missing reviews. Those scene
- results are mixed; the selected reading-room image above does not establish a
- general visual advantage. Each pair has one generation per condition, so the
- gallery is evidence to inspect rather than a general success rate.
- The [earlier Claude Code lantern samples](docs/plugin-quality-evidence.md#claude-code-samples)
- had no baseline and remain separate from those paired scene comparisons.
- Keep each result tied to its tested host, model, task, and plugin revision.
- ## Support development
- If Blender Agent Studio helps you build or inspect scenes, consider supporting
- its maintainer through [GitHub Sponsors](https://github.com/sponsors/ifBars) or
- [Ko-fi](https://ko-fi.com/ifbars). Contributions help sustain the time spent on
- Blender and agent compatibility, reproducible examples, bug fixes, and benchmark
- runs that report failures as well as improvements.
- The plugin stays free, MIT-licensed, and runs Blender locally. Sponsorship is
- optional and does not purchase priority support or feature commitments. Sharing
- a scene, reporting a reproducible bug, or improving the docs also helps.
- ## Star history
- <a href="https://www.star-history.com/?repos=ifBars%2Fblender-agent-studio&type=date&legend=top-left">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=ifBars/blender-agent-studio&type=date&theme=dark&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=ifBars/blender-agent-studio&type=date&legend=top-left" />
- <img alt="Blender Agent Studio star history chart" src="https://api.star-history.com/chart?repos=ifBars/blender-agent-studio&type=date&legend=top-left" />
- </picture>
- </a>
- ## Contributing
- Found a bug? [Open an issue](https://github.com/ifBars/blender-agent-studio/issues)
- with your Blender version, what you asked for, and what happened. A render or
- error log helps.
- Made something with the plugin? [Share an example](https://github.com/ifBars/blender-agent-studio/issues/new?template=share-an-example.yml)
- with your prompt, agent/model, Blender version, and a render. If you want it
- featured in the docs, say so and include the build script when you can. Only
- share files you have permission to publish.
- For code changes, see the [development guide](docs/development.md) and
- [repository instructions](AGENTS.md). Keep generated models and benchmark output
- out of commits. Review unfamiliar Blender scripts before running them; see
- [security notes](SECURITY.md).
- ## Credits and license
- [MIT](LICENSE). Powered by [Poly Haven](https://polyhaven.com), whose assets are
- [CC0](https://polyhaven.com/license).
- This is an independent project, not affiliated with or endorsed by the Blender
- Foundation or Poly Haven. See [third-party notices](THIRD_PARTY_NOTICES.md).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.