blenderforge 1.0.5

AI-powered Blender integration for 3D modeling and scene creation

🔥 BlenderForge

Control Blender with AI through natural language conversation

---

What is BlenderForge?

BlenderForge connects AI assistants to Blender using the Model Context Protocol (MCP). Instead of learning complex menus and Python scripts, just describe what you want:

You: Create a cozy coffee shop scene with wooden tables and warm lighting

AI: I'll create that for you...
    ✓ Setting up warm HDRI lighting from PolyHaven
    ✓ Adding wooden tables with realistic textures
    ✓ Placing coffee cups and decorations
    ✓ Adjusting camera for a cozy atmosphere

---

Quick Start

1. Install BlenderForge

pip install blenderforge

2. Install the Blender Addon

1. Download addon.py (Right-click → Save Link As)
2. In Blender: Edit → Preferences → Add-ons → Install...
3. Select addon.py and click Install Add-on
4. Enable the "BlenderForge" addon (check the checkbox)
5. Click Save Preferences to keep it enabled

3. Configure Your AI Assistant

Add to your AI client's MCP configuration:

{
  "mcpServers": {
    "blenderforge": {
      "command": "blenderforge"
    }
  }
}

4. Connect

1. In Blender, press N → BlenderForge tab → "Connect to MCP server"
2. Restart your AI assistant
3. Start creating!

---

Supported AI Assistants

AI Assistant	Developer	Status
Claude Desktop/Code	Anthropic	✅
ChatGPT Desktop	OpenAI	✅
Google Antigravity	Google	✅
VS Code + Copilot	Microsoft	✅
Cursor IDE	Cursor	✅
Windsurf	Codeium	✅
Zed Editor	Zed	✅
Continue.dev	Continue	✅

BlenderForge works with any MCP-compatible client (481+ and growing).

---

Features

Feature	Description
Scene Control	Query and modify Blender scenes
Code Execution	Run Python scripts in Blender
Screenshots	Capture viewport images
PolyHaven	Free HDRIs, textures, and models
Sketchfab	Download 3D models (API key required)
Hyper3D Rodin	AI-generated 3D from text/images
Hunyuan3D	Tencent's AI 3D generation

AI-Powered Features

Feature	Description
AI Material Generator	Create PBR materials from text or images
Natural Language Modeling	Create objects with plain English ("a red cube 2m tall")
AI Scene Analyzer	Professional critique with scores and suggestions
Smart Auto-Rig	Automatically rig characters with bone hierarchies
Auto-Lighting	Studio, cinematic, dramatic lighting presets

---

📚 Documentation

Full documentation available at: mithun50.github.io/blenderforge

Document	Description
📖 Getting Started	Installation and setup guide
🤖 AI Clients	Configuration for each AI platform
🔧 Tools Reference	Complete tool documentation (40+ tools)
✨ AI Features	AI material generator, NLP modeling, scene analysis
📦 Asset Integrations	PolyHaven, Sketchfab, AI generation
🐍 Blender API Reference	Python API quick reference
🏗️ Architecture	How BlenderForge works
🔍 Troubleshooting	Common issues and solutions
👨‍💻 Development	Contributing guide

---

System Requirements

Component	Requirement
Python	3.10+
Blender	3.0+ (4.x recommended)
OS	Windows, macOS, Linux

---

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

# Development setup
git clone https://github.com/mithun50/blenderforge.git
cd blenderforge
pip install -e ".[dev]"
pytest

---

License

MIT License - see LICENSE for details.

---

Links

• 📚 Documentation - Full docs with guides and API reference
• 📦 PyPI Package - Install via pip
• 🔌 Model Context Protocol - MCP specification
• 🎨 Blender Python API - Blender scripting reference
• 🌐 PolyHaven - Free HDRIs, textures, and models
• 🎭 Sketchfab - 3D model marketplace

---

⬆ Back to Top

Made with ❤️ by Mithun Gowda B