blender-kit

blender-kit

Agentic Blender 4.x development boilerplate — Python REPL/CLI, HTTP bridge, scene inspector, headless rendering.

Install

npx blender-kit <project-dir>
cd <project-dir>

This scaffolds a new project and installs the blender-dev CLI.

Requirements

• Node.js 18+
• Blender 4.x (download)
• Python + pip (for lint/format tools)

Configuration

blender-dev config set blenderPath /path/to/blender
blender-dev config get
blender-dev config path
blender-dev download-engine   # show download instructions

Config is stored at ~/.blender-kit/config.json.

CLI Commands

Headless (no Blender open required)

Command	Description
blender-dev run [script]	Run a Python script headlessly (default: scripts/main.py)
blender-dev render [script]	Run render script headlessly (default: scripts/render.py)
blender-dev setup	Install flake8 and black via pip
blender-dev lint [files...]	Lint Python files with flake8
blender-dev format [files...]	Format Python files with black
blender-dev download-engine	Show Blender 4.3 download instructions

Live Bridge (requires Blender open + blender_bridge addon enabled)

The bridge runs an HTTP server on port 6009 inside Blender.

Command	Description
blender-dev repl	Interactive Python REPL against running Blender
blender-dev eval <expr>	Evaluate a Python/bpy expression
blender-dev info	Show Blender version, scene name, object count
blender-dev scene	Dump active scene tree
blender-dev objects	List all objects with name/type/location
blender-dev set <path> <prop> <value>	Set an object property
blender-dev select <name>	Select object by name
blender-dev call <path> <method> [args]	Call a bpy method
blender-dev render-settings	Show render engine, resolution, samples
blender-dev reload	Reload the current .blend file
blender-dev watch	Watch .py files and notify bridge on change

REPL dot-commands

Inside blender-dev repl:

.objects          list scene objects
.scene            dump scene tree
.info             Blender version + scene info
.render-settings  render config
.help             show available dot-commands

Any other input is evaluated as a Python/bpy expression.

Project Structure (scaffolded)

<project>/
  scripts/
    main.py       # entry point for blender-dev run
    render.py     # entry point for blender-dev render
  addons/
    blender_bridge/
      __init__.py # HTTP bridge addon (port 6009)

Ports

Port	Service
6009	Blender HTTP bridge

License

MIT