blender-ai-addon README

The project's README from github.com/hitkeeen/blender-ai-addon. As one markdown file: README.md.

AI Copilot for Blender

Add-on для Blender, который превращает вьюпорт в чат с агентом OpenCode. Опишите словами или покажите картинкой, что нужно создать или изменить — агент сгенерирует Python-код (bpy) и аддон выполнит его прямо в сцене.

Главная особенность: аддон сам скачивает портативный OpenCode при первом запуске — устанавливать OpenCode в систему не нужно.

Как это работает

Панель в Blender (N-sidebar)
   │  кнопка "Install OpenCode"
   ▼
Скачивание портативного бинарника (~80 МБ) из GitHub Releases
и распаковка в папку аддона            ← основная установка не нужна
   │  кнопка "Start Server"
   ▼
opencode serve --port 4096 (скрытый процесс)
   │  POST /session/:id/message
   ▼
Агент читает scene_context.txt + reference_image.png,
возвращает ```python```-скрипт
   │
   ▼
Аддон исполняет его в bpy и показывает результат;
при ошибке лог автоматически уходит агенту на исправление

Возможности

Установка

  1. Скачайте zip из Releases
  2. Edit > Preferences > Add-ons > Install → выберите zip
  3. Откройте сайдбар (N) → вкладка AI Copilot
  4. Нажмите Install OpenCode — аддон скачает и распакует рантайм (~80 МБ, прогресс-бар)
  5. В AI Settings выберите провайдера, вставьте API-ключ и модель
  6. Нажмите Start Server — статус сменится на «OpenCode ready»
  7. Пишите запрос и жмите Send

Из исходников

git clone https://github.com/BlenderGPT3D/blender-ai-addon.git

Заархивируйте содержимое репозитория в zip (чтобы blender_manifest.toml был в корне) и установите как выше.

Настройка модели

Провайдер Ключ Пример модели
OpenAI OPENAI_API_KEY gpt-4o
OpenRouter OPENROUTER_API_KEY anthropic/claude-sonnet-4
Anthropic ANTHROPIC_API_KEY claude-sonnet-4
Groq GROQ_API_KEY llama-3.2-90b-vision
DeepSeek DEEPSEEK_API_KEY deepseek-chat
Ollama (локально) не нужен llava

Для работы с картинками нужна vision-модель (gpt-4o, claude-*, llava).

Где что лежит

Портативный рантайм и рабочие файлы хранятся в данных пользователя Blender:

<blend-user-dir>/datafiles/ai_copilot/
├── runtime/     # бинарник opencode
├── workspace/   # AGENTS.md, scene_context.txt, reference_image.png
├── config/      # opencode.json (правила и разрешения агента)
├── data/        # сессии OpenCode
└── server.log   # лог сервера (для отладки)

Траблшутинг

Дорожная карта

Лицензия

MIT — см. LICENSE.

blender-ai-addon (hitkeeen/blender-ai-addon)

Searching Database…

217 ·GitHub
Blender-ai-addon
这是什么？这是一个 Blender 插件，能把 Blender 的视口变成与 AI 代理（OpenCode）聊天的窗口：用文字描述或展示一张你想要的图片，代理就会生成 Python（bpy）代码，并由插件直接在你的场景中运行。
这是一个独立应用，还是 Blender 插件？它是一个 Blender 插件（add-on），需要在 Blender 内部通过 Preferences 安装，不是单独的应用——代理聊天界面位于 3D 视口内的侧边栏标签页中。
怎么安装并开始使用？从 Releases 下载 zip 文件，通过 Edit > Preferences > Add-ons > Install 安装，打开侧边栏（按 N）→ AI Copilot 标签页，点击 'Install OpenCode' 下载运行时（约 80MB），在 AI Settings 中设置你的提供商/API 密钥/模型，然后点击 Start Server 并发送你的第一条消息。
我需要自己安装 OpenCode 或先获取 API 密钥吗？不需要单独安装 OpenCode——第一次点击 'Install OpenCode' 时，插件会把一个便携版的 OpenCode 运行时下载到自己的文件夹里。但你需要为所选的云端提供商（OpenAI、OpenRouter、Anthropic、Groq、DeepSeek）准备一个 API 密钥，除非你使用本地 Ollama 模型，那种情况不需要密钥。
让代理自动运行代码有什么隐患？生成的 bpy 代码会在你的场景中自动执行（Auto-run），如果出错，代理会读取服务器日志并尝试自动修复；为安全起见，代理被明确禁止使用 shell，只能编辑自己工作文件夹内的文件。
支持哪些操作系统？支持 Windows、macOS 和 Linux，x64 和 arm64 架构都可用——安装程序会自动从 GitHub Releases 下载与你平台匹配的 OpenCode 版本。
可以用图片而不只是文字来创建或编辑模型吗？可以，你可以附加图片文件或视口截图，代理会据此生成 bpy 代码，但这需要具备视觉能力的模型，例如 gpt-4o、某个 Claude 模型或 llava。
能不能完全在本地运行，不接入任何云端 API？可以，你可以把提供商设置为本地 Ollama（比如 llava 模型），完全不需要 API 密钥，不过图片输入仍然需要具备视觉能力的模型。
这个插件接下来有什么计划？路线图包括：为正在运行的代理会话添加取消按钮、把代理生成的网格/资源直接导出到 .blend 文件中，以及由 Meshy 或 Tripo 驱动的图片转 3D 模式。
What are similar projects?genex-desktop, mcp-for-blender, NextChat, quivr, routeVSCODE, AstrBot, opensquilla, devika
Which topics is it in?groq, 3d-graphics, blender, openrouter, code-generation, gpt, chatgpt, 3d, ollama, deepseek, generative-ai, anthropic
Creator
hitkeeen
Size
<0.1 MB
Stars
217
Updated
CommitOct 09
Age
8d
Commits · 90 Days