bithatch/opensim-blender repository overview

⁠opensim-blender

opensim-blender is a containerized Blender image tailored for the OpenSim AI stack.

It is intended to be used as part of the OpenSim Stack project: "A docker stack to get an AI integrated virtual world up and running in minutes."

⁠What This Image Does

• Runs Blender with a virtual display (xvfb)
• Enables the Blender MCP⁠ add-on
• Exposes the Blender MCP socket on container port 8996
• Starts in /workspace
• Uses persistent directories for config, cache, and data

⁠Required Volume Mounts

• opensim-workspace -> /workspace
• blender-config -> /root/.config/blender
• blender-cache -> /root/.cache/blender
• blender-data -> /root/.local/share/blender

⁠Quick Start

docker run --rm \
  -e BLENDER_MCP_HOST=0.0.0.0 \
  -e BLENDER_MCP_PORT=8996 \
  -p 8996:8996 \
  -v opensim-workspace:/workspace \
  -v blender-config:/root/.config/blender \
  -v blender-cache:/root/.cache/blender \
  -v blender-data:/root/.local/share/blender \
  bithatch/opensim-blender:latest

⁠Project Links

• Main AI Stack (opensim-ai-docker): https://github.com/opensim-stack/opensim-ai-docker⁠
• opensim-blender on GitHub: https://github.com/opensim-stack/opensim-blender⁠
• Blender MCP add-on: https://github.com/ahujasid/blender-mcp⁠
• Related MCP servers:
  • opensim-console2mcp: https://github.com/opensim-stack/opensim-console2mcp⁠
  • opensim-metaverse2mcp: https://github.com/opensim-stack/opensim-metaverse2mcp⁠
  • opensim-opencode: https://github.com/opensim-stack/opensim-opencode⁠