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 в чат с ИИ-агентом (OpenCode): опишите текстом или покажите картинку того, что хотите, и агент сгенерирует код на Python (bpy), который аддон сразу выполнит в вашей сцене.
Это отдельное приложение или плагин для Blender?Это аддон (плагин) для Blender, который устанавливается изнутри Blender через Preferences, а не отдельное приложение — чат с агентом находится во вкладке в боковой панели внутри 3D-вьюпорта.
Как установить и начать пользоваться?Скачайте zip из Releases и установите его через Edit > Preferences > Add-ons > Install, откройте боковую панель (N) → вкладку AI Copilot, нажмите 'Install OpenCode', чтобы скачать рантайм (~80 МБ), укажите провайдера/API-ключ/модель в AI Settings, затем нажмите Start Server и отправьте первое сообщение.
OpenCode нужно устанавливать самому или сначала получить API-ключ?Отдельно ставить OpenCode не нужно — аддон сам скачает переносимую версию OpenCode в свою папку, когда вы впервые нажмёте 'Install OpenCode'. А вот API-ключ для выбранного облачного провайдера (OpenAI, OpenRouter, Anthropic, Groq, DeepSeek) понадобится, если только вы не используете локальную модель Ollama — для неё ключ не нужен.
В чём подвох того, что агент сам запускает код?Сгенерированный код bpy выполняется в вашей сцене автоматически (Auto-run), и если он выдаёт ошибку, агент читает лог сервера и пытается исправить её сам; ради безопасности агенту явно запрещён доступ к оболочке (shell), и он может редактировать файлы только внутри своей рабочей папки.
Какие операционные системы поддерживаются?Windows, macOS и Linux, как на x64, так и на arm64 — установщик автоматически скачивает с GitHub Releases сборку OpenCode, подходящую для вашей платформы.
Можно создать или отредактировать модель по картинке, а не только по тексту?Да, можно приложить файл изображения или скриншот вьюпорта, и агент сгенерирует код bpy на его основе, но для этого нужна модель с поддержкой зрения, например gpt-4o, модель Claude или llava.
Можно ли всё запускать полностью локально, без облачного API?Да, можно выбрать в качестве провайдера локальный Ollama (например, модель llava) — API-ключ вообще не нужен, хотя для работы с изображениями по-прежнему нужна модель с поддержкой зрения.
Что планируется дальше для аддона?В планах: кнопка отмены для запущенных сессий агента, экспорт созданных агентом мешей/ассетов прямо в файл .blend и режим «картинка в 3D» на основе Meshy или Tripo.
What are similar projects?blender-ai-mcp-addon, genex-desktop, NextChat, mcp-for-blender, quivr, routeVSCODE, AstrBot, opensquilla
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
10d
Commits · 90 Days