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…

What is this?This is a Blender add-on that turns the Blender viewport into a chat window with an AI agent (OpenCode): describe in text or show an image of what you want, and the agent generates Python (bpy) code that the add-on runs directly in your scene.
Is this a standalone app or a Blender plugin?It is a Blender add-on (plugin) installed from inside Blender via Preferences, not a separate application — the agent chat lives in a sidebar tab inside the 3D viewport.
How do I install and start using it?Download the zip from Releases and install it via Edit > Preferences > Add-ons > Install, open the sidebar (N) → AI Copilot tab, click 'Install OpenCode' to fetch the runtime (~80MB), set your provider/API key/model in AI Settings, then click Start Server and send your first message.
Do I need to install OpenCode myself, or get an API key first?No separate OpenCode install is needed — the add-on downloads a portable OpenCode runtime into its own folder the first time you click 'Install OpenCode'. You do need an API key for your chosen cloud provider (OpenAI, OpenRouter, Anthropic, Groq, DeepSeek), unless you use a local Ollama model, which needs no key.
What's the catch with letting the agent run code automatically?Generated bpy code executes automatically in your scene (Auto-run), and if it errors the agent reads the server log and tries to self-fix it; for safety the agent is explicitly denied shell access and can only edit files inside its own working folder.
Which operating systems does it support?Windows, macOS and Linux, on both x64 and arm64 — the installer automatically fetches the matching OpenCode build for your platform from GitHub Releases.
Can I create or edit a model from an image instead of just text?Yes, you can attach an image file or a viewport screenshot and the agent generates bpy code based on it, but this requires a vision-capable model such as gpt-4o, a Claude model, or llava.
Can I run everything fully locally without any cloud API?Yes, you can set the provider to local Ollama (e.g. the llava model), which needs no API key at all, though image input still requires a vision-capable model.
What's planned next for the add-on?The roadmap includes a cancel button for running agent sessions, exporting agent-generated meshes/assets directly into the .blend file, and an image-to-3D mode powered by Meshy or Tripo.
Creator
hitkeeen
Size
<0.1 MB
Stars
217
Updated
CommitOct 09
Age
8d
Commits · 90 Days