blender-plugin

Name: blender-plugin
Author: scenario-labs

Verified

Scenario for Blender: AI images, video, 3D and PBR materials in the viewport, plus a local MCP server for agents. Blender 5.0+ extension, GPL-3.0-or-later.

301stars

39forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/scenario-labs/blender-plugin

Getting Started

Guides for using ai agents skills like blender-plugin.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 10/16/2026

{
  "issues": [
    {
      "file": "README.md",
      "line": 172,
      "type": "secret-exfiltration",
      "message": "Instruction appears to send credentials/secrets to an external endpoint",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-10-16T08:46:39.013Z",
  "npmAuditRan": false,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

Compare with similar skills

See how blender-plugin compares with popular alternatives.

blender-plugin vs ecc

See comparison

blender-plugin vs rea

See comparison

blender-plugin vs hermes agent

See comparison

README.md

Frequently Asked Questions

What is blender-plugin?

blender-plugin is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by scenario-labs. Scenario for Blender: AI images, video, 3D and PBR materials in the viewport, plus a local MCP server for agents. Blender 5.0+ extension, GPL-3.0-or-later. It has 301 GitHub stars.

Is blender-plugin safe to use?

Yes. blender-plugin passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install blender-plugin?

Clone the repository with "git clone https://github.com/scenario-labs/blender-plugin" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is blender-plugin written in?

blender-plugin is primarily written in Python. It is open-source under scenario-labs on GitHub, so you can review or fork the full source.

Are there alternatives to blender-plugin?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh blender-plugin against similar tools.

AI Courses · Agentic AI, LLM Engineering & MCP

Beginner to professional · First lesson free · Lifetime access

20% off

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

280,680

VelaTerm claude-code-pro-course

Experimental. Bring Scenario image, video, 3D, PBR material, audio and 360 environment generation into Blender. Use scene captures and selected meshes as inputs, explore camera moves, and turn a written scene description into a greybox layout with Blockout. A compact composer, sidebar, expanded Studio view and local MCP server provide access from your scene. This is a Python extension with pinned SDK dependency wheels, licensed GPL-3.0-or-later. Read the known limitations before relying on a workflow.

The Scenario sidebar with all creation tabs and a clearly labelled offline Image example

Requirements

Blender 5.0 or later, as declared in the extension manifest.
A Scenario account with API access, an API key and its secret. See Obtain your API key and Scenario help for current account requirements.
An internet connection and Blender's Allow Online Access setting enabled under Edit > Preferences > System > Network before contacting Scenario.
Scenario generations and prompt helpers consume Creative Units (CU). Review the displayed estimate before Generate; models, parameters and references affect the cost. See costs and the limitations above.

Install

Install from the official extension repository so that Blender can offer updates:

Turn on Allow Online Access under Edit > Preferences > System > Network.
Open Edit > Preferences > Get Extensions > Repositories, choose Add Remote Repository and enter https://blender.scenario.com/repo/index.json.
Find Scenario in Get Extensions and install it. It appears as "Scenario" in Blender's Add-ons list.
In Scenario, open Organization settings > API Keys > Add API Key and follow the instructions to obtain the key and secret.
Open Edit > Preferences > Add-ons > Scenario. Leave Credentials set to Saved in Blender, paste the key and secret, then press Test connection. Choose an Output Folder for generated files.

To install from a ZIP instead, download scenario-<version>.zip from the releases page and keep it zipped. Verify your download: for releases that include SHA256SUMS, save the ZIP, scenario-handbook-<version>.html and SHA256SUMS together, check them with sha256sum -c SHA256SUMS (macOS: shasum -a 256 -c SHA256SUMS) and, with the GitHub CLI, run gh attestation verify scenario-<version>.zip -R scenario-labs/blender-plugin (details). Historical v* releases have neither. Drag the ZIP onto a Blender window, or use Edit > Preferences > Get Extensions > Install from Disk, then continue with step 4. A ZIP copy does not update itself; see Updates.

Updates

A copy installed from the official repository updates through Blender. Open Preferences > Add-ons > Scenario > Updates for update checks and Blender's native Get Extensions manager. Enable Allow Online Access before checking. Updates are installed only when you choose them in Blender. The repository offers releases from 0.10.0 on.

A ZIP copy lives in Blender's local repository and does not update itself. Keep updating it with Install from Disk, followed by a restart, or switch to the repository: uninstall the ZIP copy first, install Scenario from the repository, then enter your key and secret again. Uninstalling deletes the ZIP copy's storage, including its stored jobs and the media that the video, sound and Film review strips Scenario added play from; past generations remain available under Project history (cloud) in Generations. Never keep both copies installed. Read Switch from a ZIP to the repository before switching, and the update guide for compatibility and manual fallback.

Why not extensions.blender.org

The Blender Extensions terms restrict extensions whose functionality depends on external registration, keys or payments, including access to external services. Scenario requires an account and API credentials, so this extension is distributed through its own repository at https://blender.scenario.com/repo/index.json, with each release's ZIP also attached to its GitHub release. Its manifest declares the permissions it uses and their reasons.

Quick start

In the 3D viewport, press N and open Scenario, or use the Scenario button in the viewport header. Pick a lane and model, enter a prompt, add any required reference and inspect the estimate before Generate. Results appear in Generations and your Output Folder, with actions for viewing or importing supported media. The user guide describes each lane and its controls.

Features

Image: generate from text or reference images and use results as textures or references.
Video: generate from prompts, images or scene playblasts.
3D: generate meshes, run provider edit tasks on a selected mesh and apply a saved edit back to it.
Materials: generate saved PBR texture sets and apply them explicitly to a chosen mesh material slot.
Audio: generate speech, music or sound effects and add results to the sequencer.
Render Image: use a scene capture and look references to produce a still.
Render Video: work with timeline captures, a camera path planner and style references.
Blockout: turn a scene description into a greybox layout, then refine or rebuild it.
Environment: generate 360 panoramas, HDRIs and upscales, then apply them to the scene World.
Prompt tools and model picker: browse models and prepare prompts; prompt helpers can spend credits.
Floating composer: access the current lane from the viewport.
Generations: inspect local results and available project history.
Expanded Studio view: run workflows and browse or organize Library assets.
Film tasks: turn a JSON recipe into shots, a timeline, a review scene and an exported video.

Agents (MCP)

The local scenario-blender server connects an authorized agent to the open scene and generation into it. The hosted mcp.scenario.com server provides platform-wide collections, training, workflows and usage without requiring Blender; connect both when needed.

The default local endpoint is http://127.0.0.1:9876/mcp. Agents (MCP) shows its status and bearer token and provides client setup for Claude Code, Cursor, Claude Desktop and Codex under the name scenario-blender. Treat the token and copied setup as secrets. Connected agents can read the scene and request paid work; arbitrary Python execution is a separate opt-in permission, disabled by default.

Use the MCP reference for complete client setup, tool contracts, security controls and headless configuration. The headless entry point is:

blender --background scene.blend --command scenario_blender

Authentication

Scenario API requests use an API key and secret. Saved Blender credentials are the default; Credentials > Environment explicitly selects an environment pair instead. The extension does not provide browser OAuth sign-in. The hosted Scenario MCP service has its own authentication, described in its linked docs. Blender stores saved credentials in its preferences, not an OS keychain.

What leaves your machine

Cost previews send prompts and parameters to https://api.cloud.scenario.com while you edit, before Generate. Upload reference sends files, scene captures or exported meshes; generation and prompt tools spend credits. Catalogs, thumbnails and result previews load from Scenario; cloud history and Library assets load when requested. Saved keys, prompts, job state and media remain in Blender preferences, ex