OpenBlender

An addon that brings generative workflows directly into Blender. Generate images, videos, 3D models, and receive AI assistance without leaving Blender.

v0.38.0 Blender 5.2 LTS NVIDIA 16+GB VRAM Windows Only
Core

Features

Fourteen modules that cover generation, IMG to IMG, LoRA, HDRI, rigging, chat, and remote control.

Viewport to IMG

Watch

Generate images with real-time viewport capture. Works in FreeView & CameraView.

  • Manual "Run" or auto "Run on Change" modes
  • Adjustable megapixels & steps
  • Auto-numbered output in Image Editor

IMG to VID

Watch

Create videos from a starting image using LTX 2.5. Auto-add to Video Sequencer.

  • Single start image + motion prompt
  • Configurable frame count & resolution
  • Triggerable from AI Chat

VID / TEXT / IMG to VID

Watch

Generate videos from a variety of inputs using LTX 2.5.

  • Text prompt → video
  • Image + prompt → video
  • IC-LoRA depth viewport camera anim to video (With optional FirstFrame)

IMG to 3D

Watch

Convert images into GLB models via Pixal3D. Imported with textures.

  • Import image → Start → 3D model
  • Models downloaded via Blender Preferences → Download Models

AI Chat — Agent Harness

Watch Watch

Agent harness via OpenRouter or Unsloth Studio (local). TUI floating overlay, not a toy chat.

  • Harness UI — role headers, statusline (model · ctx · compactions), reasoning toggle
  • Live thinking streaming, Auto-compaction, Prompt queueing, vision self correction

MCP Server

Watch

HTTP/SSE server (Hermes/OpenCode) for remote Blender control.

  • Same as "AI Chat", but in your favorite harnesses
  • Local via Unsloth Studio server, or OpenRouter (offers free inference, API keys are free)

IMG to IMG (Editor)

Transform the displayed image with a prompt, right inside the Image Editor.

  • Dedicated Image Editor sidebar panel
  • Adjustable megapixels & steps
  • Auto-numbered output: IMG_to_IMG.001…

LoRA Support

Watch

Add LoRA models to your generation workflows.

  • Open IMG to IMG / IMG to VID in ComfyUI WebUI
  • Add your LoRA node(s) and save the API workflow
  • Your LoRA stack is now applied automatically in Blender

TXT to HDRI

Watch

Generate 360° panoramic HDRI environment maps from text prompts using FLUX.2-Klein + HDRI LoRA.

  • Full equirectangular 360° panoramic output
  • Klein 9B HDRI LoRA — tuned for panoramic scenes
  • Apply directly as World environment in Blender

TXT to RIG

Watch

Generate a humanoid rig with motion from a text prompt.

  • Motion prompt → animated humanoid dummy
  • Auto-imported into scene as a rigged GLB
  • Auto First Person camera setup
  • Triggerable from AI Chat

TXT to IMG

Watch

Generate images from text prompts. Result loads automatically into the Image Editor.

  • Z-Image Turbo, FLUX.2-Klein or KREA2 workflows
  • Adjustable steps, width & height
  • Randomise Seed checkbox
  • Triggerable from AI Chat

IMG to RIG (Humanoid)

Generate rigged humanoid characters from images.

  • Image input → still posed humanoid dummy rigged with bones
  • Auto-imported as GLB with armature
  • Accessible from sidebar panel

VID to RIG

Generate rigged animation from video input.

  • Load video → process through ComfyUI
  • Animated character matching video motion
  • Simplified video loading workflow

MESH to RIG

Adds automatic bones to any existing mesh — humanoids, animals, creatures.

  • Works on your current scene geometry
  • Auto-weight painting and bone binding
  • GLB export with full rig

Key Capabilities

Designed to stay out of your way.

Non-Blocking

Background threads keep Blender responsive

VSE Integration

Videos auto-add to Video Sequencer

Modular UI

Toggle panels to reduce clutter

Comfy Kitchen

Native fast attention, no extra wheels

Requirements

What you need before getting started.

System

  • Windows
  • Blender 5.2 LTS (untested on prior)
  • NVIDIA GPU with 16+ GB VRAM recommended

MCP Server (Optional)

  • Network access for HTTP (default port: 9876)
  • Optional: API key for authentication

Chat (Optional)

  • OpenRouter: API key + internet
  • Unsloth Studio: local — auto-discovers llama-server port, auto-detects model & ctx length (leave Model ID empty)

Installation

Four steps to get everything running.

1

Install the Extension

  1. Download the OpenBlender extension package
  2. Blender → Edit → Preferences → Extensions
  3. Click "Install from Disk", select the .zip
  4. Enable the extension by checking the checkbox
2

Install ComfyUI (AIO)

  1. Install Visual C++ Redistributable: aka.ms/vc14/vc_redist.x64.exe
  2. Install Windows PowerShell 7: PowerShell-7.5.4-win-x64.msi
  3. Update your NVIDIA drivers to the latest version
  4. Blender → Edit → Preferences → Add-ons → OpenBlender → ComfyUI Setup → click "Install" — this installs ComfyUI and all required dependencies
3

Set Up in Blender Preferences

Open Edit → Preferences → Add-ons → OpenBlender:

  1. Verify ComfyUI Installation — set your ComfyUI path (e.g. D:\ComfyUI_windows_portable)
  2. Configure (Optional) — set your AI provider (OpenRouter API key or Unsloth Studio; Model ID can be left empty for auto-detect)
4

Update

  1. Check the addon's Gumroad page for new versions and download updates
  2. Replace the content of Blender\5.2\extensions\user_default\openblender
  3. Open Blender → Preferences → Add-ons → OpenBlender → Verify ComfyUI Path → Instal Nodes / Dependencies / Models if missing After a new update that brings new features

Usage

Step-by-step guides for each module.

MCP Server

Watch

Remote Blender control via HTTP/SSE.

  1. Open sidebar panel (N key → OpenBlender tab)
  2. Click "Start Server"
  3. Connect MCP client to http://localhost:9876/sse

AI Chat — Harness

Watch Watch

Agent harness inside Blender — TUI floating overlay (opencode/hermes-style), not a simple chat.

  1. Enable the Chat panel in addon Preferences
  2. Configure provider: OpenRouter (API key) or Unsloth Studio (local, auto-discovers port & model)
  3. Click the floating chat button — statusline shows model · ctx used/total (%) · compactions

Harness notes: thinking streams live as ▾ reasoning (rolling last-10 tail), then collapses to ▸ reasoning per message (global think toggle). Long tasks auto-compact at 80% context, queue while busy, and run up to 200 tool rounds with stall detection — cancel anytime. Unsloth Studio model/reload is picked up automatically.

Vision & Image Attachments

The AI chat supports vision-capable models for analysing images directly inside Blender. Vision is auto-detected — screenshot/viewport tools are only offered to the agent when the model actually accepts images.

  1. Attach an image to any prompt (attachment chip or Ctrl+V in the floating chat)
  2. Or ask the agent to look at Blender: "take a screenshot and tell me what's wrong with my lighting"
  3. The agent can also read the current Image Editor image (capture_image_editor) or the viewport (capture_viewport)

Requires a vision-capable model. Images are sent as compressed JPEG to stay within context limits.

Batch Generation

Request multiple images at once for keyframe sequences:

  • "Generate 3 continuous keyframes of Batman — first, middle, and end frames"
  • "Create 5 variations of a mountain landscape"

Chat can be used to rewrite / refine your prompts.

Viewport to IMG

Watch

Generate images from your viewport.

Manual Mode

  1. Set mode to "Run" in sidebar
  2. Adjust parameters → click "Generate"

On-Change Mode

  1. Set mode to "Run (on change)" → click "Start"
  2. Modify viewport — generation triggers when inputs are released

Output: Images appear in Image Editor as Result, Result_001, Result_002

IMG to VID

Watch

Generate videos from a starting image using LTX 2.5.

  1. Display the start image in the Image Editor
  2. Open the IMG to VID panel (N key → OpenBlender tab)
  3. Enter a motion prompt, set Frame Count and Megapixels
  4. Click "Generate Video"

The generated video auto-adds to the Video Sequencer if the scene is selected.

AI Video Prompt Generation

Ask the AI Chat to write a motion-focused video prompt from your start image — with a vision-capable model it can see the current Image Editor image and describe subject motion, camera motion, and lighting changes.

VID / TEXT / IMG to VID

Watch

Generate videos from text, image, or video inputs using LTX 2.5.

Text to Video

  1. Open the OpenBlender sidebar panel (image editor) (N key → OpenBlender tab)
  2. Select the TXT to VID pannel
  3. Enter a text prompt describing the scene and motion
  4. Click "Generate"

IC-LoRA Depth Control

The IC-LoRA depth model gives LTX 2.5 structural guidance for consistent motion across frames. Models are downloaded automatically on first use.

IMG to 3D

Watch

Convert 2D images to 3D GLB models via Pixal3D.

  1. Import an image
  2. Click "Start"
  3. 3D model imports into Blender as GLB, with textures

IMG to IMG (Editor)

Watch

Transform images from inside the Image Editor side panel.

  1. Open any image in the Image Editor
  2. Press N → find the OpenBlender tab in the sidebar
  3. Set your Prompt, Megapixels, and Steps
  4. Click "Generate"
  5. Result appears as IMG_to_IMG.001, IMG_to_IMG.002… in the Image Editor

MCP / AI Chat

IMG to IMG is also available via the MCP server and AI Chat using the trigger_remix tool. Agents can transform any displayed image remotely with a text prompt.

Image Capture

Request the current state as an image:

  • "Send me the current image" → Agent calls capture_image_editor
  • "Show me the viewport" → Agent calls capture_viewport

Both return base64 JPEG images that the agent can display in the chat.

TXT to HDRI

Watch

Generate 360° equirectangular HDRI environment maps from text prompts using FLUX.2-Klein + Klein 9B HDRI LoRA.

  1. Set viewport shading to Material Preview or Rendered so the environment is visible
  2. In Properties → World, ensure a World data block exists — click "New" if the slot is empty
  3. Open the OpenBlender sidebar panel (N key → OpenBlender tab)
  4. Enter a Prompt describing the environment
  5. Set Megapixels and Steps
  6. Click "Generate HDRI"
  7. The generated panorama is automatically applied to the scene World as an environment texture

TXT to RIG

Watch

Generate a humanoid dummy rig with motion from a text prompt using HY-Motion. The output is a generic animated skeleton — not a character with specific appearance or textures.

  1. In Blender, open the sidebar (N) → OpenBlender tab → TXT to RIG panel
  2. Enter a text prompt describing the motion (e.g. "walking forward", "jumping", "waving hand")
  3. Click "Generate" — HY-Motion runs in ComfyUI and produces an animated GLB
  4. The humanoid dummy rig is automatically imported into the scene

Tips

  • Prompts should describe motion only — HY-Motion outputs a generic humanoid skeleton regardless of character description
  • Use it as an animation base: retarget the motion onto your own character rig
  • The AI Chat can trigger generation via the trigger_txt_to_rig MCP tool
  • Models are downloaded from Blender Preferences

LoRA Support

Watch

Add LoRA models to your generation workflows.

  1. Open your IMG to IMG or IMG to VID workflow in ComfyUI WebUI
  2. Add your LoRA node(s) to the workflow graph
  3. Save the API workflow as .json
  4. Your LoRA stack is now applied automatically in Blender on every generation

Any ComfyUI-compatible LoRA works. Stack multiple LoRAs in a single workflow. Find models at CivitAI.

IMG to RIG (Humanoid)

Generate a rigged humanoid from the image shown in the Image Editor.

  1. Enable the IMG to RIG (Humanoid) panel in addon Preferences
  2. Display a humanoid image in the Image Editor
  3. Open the sidebar → OpenBlender → IMG to RIG (Humanoid)
  4. Click Generate Rig from Image — rigged GLB imports into scene

VID to RIG

Generate rigged animation from video.

  1. Enable the VID to RIG panel in addon Preferences
  2. Open the sidebar → OpenBlender → VID to RIG
  3. Load a video file showing human motion
  4. Click Generate — animated rig imports into scene

Configuration

Access via Edit → Preferences → Add-ons → OpenBlender. ComfyUI starts automatically when a job needs it (manual start also works).

MCP Server

Port9876
API Keyoptional
Auto Starton/off
Uses withHermes/OpenCode, Claude Code etc..

LLM Provider

ProviderOpenRouter / Unsloth Studio
OR API Keyyour-key
OR Modelmoonshotai/kimi-k2.5
Unsloth Studioauto-detect port, model & ctx

API Reference MCP

MCP Server endpoints and exposed Blender capabilities — 2,400+ tools covering the full bpy.ops API.

GET/Server status
GET/sseSSE connection for MCP protocol
POST/messageSend messages to server
Scene Manipulation Object Creation Object Modification Material Editing Rendering Control Animation Tools Viewport Operations

Version History

v0.38.0 Blender 5.2 LTS Brain, Operator Toolset & Agent Harness
Knowledge base rebuilt on Blender 5.2 LTS manual + API — instant search (~35x faster), creative-direction brain Full native operator toolset — 2,400+ MCP tools covering the whole bpy.ops API Rigging workflows — IMG to RIG (Humanoid), VID to RIG, MESH to RIG KREA2 text-to-image + LTX 2.5 video pipeline (IMG/TXT/VID to VID) Standalone OpenBlender-HyMotion-CRT & OpenBlender-SkinTokens-CRT nodes — no isolated envs, faster HF downloads Workflows repo with one-click sync (PGCRT/OpenBlender-Workflows) + ComfyUI auto-launch (no WebUI pop-up) Unsloth Studio provider — auto-discovers llama-server port, auto-detects model & context length Floating Chat harness UI — TUI style, role headers, statusline (model · ctx used/total · compactions) Live reasoning — reasoning_content → <think> streaming, rolling last-10 tail while live, collapsed ▸/▾ per message afterward Auto-compaction (opencode-style) — 60% exact count, 80% summarize & resume; 200-iter cap with 4-round stall detection, no global timeout Context epochs, archive & recall — evicted turns indexed (lexical search), forced recall on compaction, search_conversation tool Prompt queueing — send while running queues and drains automatically Self-healing tool calls — JSON repair, close-match suggestions, dedup of 3rd identical call, episodic failure memory Web search (opt-in, DuckDuckGo) + vision gating + image attachments in chat (chip / Ctrl+V) Knowledge & efficiency — cache_prompt, tool subsetting + find_tool, usage-boost, runtime RNA, bpy-prefetch, conditional system prompt Self-verifying execute_python — scene diff attached; live agent harness tests (house/forest/tower) guard regressions UI standardization — unified Prompt / Settings / Generate panels, panel visibility groups, Remix → IMG to IMG rename Progress bar mirrors the ComfyUI sampler step by step, with the running node's name
v0.37.0 AIO Simplification and MCP Retrieval Rewrite
Simplified ComfyUI installer flow Workflow update system Knowledge-based MCP search
v0.36.3 Wheel Update for FlashAttention
FlashAttention wheel update PyTorch 2.11 support LTX 2.3 model v1.1 update
v0.36.2 IMG to IMG Reduce Latency
Direct File Copy Upload (no HTTP overhead) Debounce 1.0s → 0.1s
v0.36.1 Video Pipeline & MCP Hardening
TXT to VID 1x IMG to VID 3x IMG to VID (renamed) VID to VID Unused Models Checker ComfyUI Progress Bar MCP Localhost Default Allow Remote Access Preference
v0.31.5 Model Paths & Install UX
Custom Model Paths Custom Stable Forks Per-file Download Progress Addon's Settings re-Organization
v0.31.0 Feature & Architecture Update
TXT to RIG SKILL Improvements Codebase Reorganisation Light Installer Nodes/Deps/Models download from addon's settigns
v0.30.1 Quality Update
Improved IMG to VID Workflow base settings Vision / Keyframe Image Analysis AI Video Prompt from Keyframes Batch Generation — Continuous Keyframes Automatic Prompt Enhancement Motion-Focused Video Prompts MCP Skill Rewrite IMG to IMG MCP Tool Image Capture Tools (Editor & Viewport)
v0.30.0 Feature Update
TXT to IMG Panel Randomise Seed — TXT to IMG Chat Auto-Display — TXT to IMG & HDRI Sent to ComfyUI Agent Response Chat UI — Removed Role Labels Chat UI — Text Vertical Centering Fix ComfyUI Manager in Installer
v0.29.0 Feature Update
Instant WS Completion Workflow Config JSON Correct Output Node Resolution Interrupt Button Queue Position Display Graceful Stop Denoise Hidden for Flux-KLEIN Send to VID Frame Buttons WS Decompression Fix 15 New MCP Tools (53 → 68 total) Lighting Tools Camera Cinematography Tools Shader Node Graph Tools Generation Pipeline Tools
v0.28.2 Patch
Randomise Seed — IMG to IMG HDRI workflow model name correction
v0.28.0 Feature Update
TXT to HDRI FLUX.2-Klein HDRI LoRA 360° Panoramic Generation Verify & Update Models Tool
v0.27.0 Feature Update
IMG to IMG LoRA Support Send to IMG→3D Streaming Chat Chain-of-Thought
v0.26.0 Initial Release
MCP Server ComfyUI IMG→IMG IMG→VID IMG→3D AI Chat Non-Blocking Viewport Monitoring

Debug

Enable console logging: Window → Toggle System Console — watch for [OpenBlender] and [PostProcess] log entries.