Repolode
sixtysevenlf

sixtysevenlf/dsh-blender-plugin

Plugin DSH que permite a um modelo de IA controlar uma sessão do Blender em execução por uma conexão TCP direta, com 16 ferramentas para capturar a viewport, editar cenas e executar tarefas sem interface gráfica.

Estrelas
715
Forks
32
Issues abertas
10
Último commit
ontem

O que é?

DSH x Blender é um plugin para o ambiente de agentes DSH (DeepSeek Harness) que conecta um modelo de IA diretamente ao Blender por um canal TCP local, sem um servidor MCP. Um addon do Blender incluído no pacote fica escutando em 127.0.0.1:9876, e um backend em Node.js, em 127.0.0.1:9877, retransmite os comandos. Assim, o modelo pode capturar a viewport 3D, executar Python na thread principal do Blender, renderizar a partir de ângulos de câmera personalizados e fazer buscas iterativas de parâmetros.

Além da edição de cenas em tempo real, o plugin oferece análise de desempenho de renderização com configurações predefinidas, decimação segura de objetos, processos `blender -b` sem interface gráfica para renderizações pesadas e processamento de geometria em lote, transações com reversão baseada em snapshots ou em objetos, uma biblioteca reutilizável de predefinições e uma camada de jobs para tarefas demoradas. Uma ferramenta de planejamento reúne verificações de contratos, auditorias de malhas, critérios de montagem e validação de exportações em 28 famílias e 186 operações.

O plugin requer o Blender 4.x ou 5.x em execução com a interface gráfica para o canal em tempo real, Node.js 20 ou posterior e uma instalação do DSH. É compatível com WSL usando o Blender para Windows, Windows, Linux nativo e macOS, e é distribuído sob a licença BSD-3-Clause.

Recursos principais

  • 01Captura a viewport 3D a partir da visão do usuário ou de qualquer ângulo de câmera personalizado, sem alterar a cena.
  • 02Executa Python na thread principal do Blender por meio de um kernel persistente para edições em várias etapas.
  • 03Executa ciclos iterativos de busca de parâmetros dentro do Blender, com limites de iterações e tempo.
  • 04Analisa as configurações de renderização e aplica predefinições de dados persistentes e de denoiser, com opção de reverter as alterações.
  • 05Executa renderizações pesadas e processamento de geometria em lote em processos do Blender sem interface gráfica.
  • 06Oferece transações com snapshots e em nível de objeto para reverter alterações.

Casos de uso

  • Permitir que um agente de IA modele, ajuste e confira objetos em uma cena aberta no Blender.
  • Executar varreduras de parâmetros para ajustar um modelo a uma silhueta de referência.
  • Renderizar em lote ou processar geometria no Blender sem interface gráfica, mantendo a interface livre.
  • Verificar folgas e interferências em montagens mecânicas antes da impressão 3D.

Início rápido

  1. 1

    Clone o repositório e entre no diretório

    cd dsh-blender-plugin
  2. 2

    Instale-o como bundle em um perfil DSH (crie um link simbólico, adicione o link ao package.json do perfil e reinicie o DSH)

  3. 3

    Inicie o Blender, conecte o complemento DSH Blender Bridge incluído e verifique a instalação com o endpoint doctor

    curl -sS http://127.0.0.1:9877/doctor

Antes de usar

  • O Blender precisa estar em execução no modo GUI, pois o canal ao vivo não funciona no modo em segundo plano.
  • É necessário um host DeepSeek Harness (DSH) e Node.js 20 ou superior.
  • O complemento MCP upstream para Blender não tem mais suporte; é necessário instalar o complemento incluído.

Tópicos

Perguntas frequentes

O que é dsh-blender-plugin?
Plugin DSH que permite a um modelo de IA controlar uma sessão do Blender em execução por uma conexão TCP direta, com 16 ferramentas para capturar a viewport, editar cenas e executar tarefas sem interface gráfica. DSH x Blender é um plugin para o ambiente de agentes DSH (DeepSeek Harness) que conecta um modelo de IA diretamente ao Blender por um canal TCP local, sem um servidor MCP. Um addon do Blender incluído no pacote fica escutando em 127.0.0.1:9876, e um backend em Node.js, em 127.0.0.1:9877, retransmite os comandos. Assim, o modelo pode capturar a viewport 3D, executar Python na thread principal do Blender, renderizar a partir de ângulos de câmera personalizados e fazer buscas iterativas de parâmetros.
dsh-blender-plugin é gratuito? Qual é a licença?
dsh-blender-plugin é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
dsh-blender-plugin ainda é mantido?
Manutenção ativa. O último commit de dsh-blender-plugin foi em 19 de out. de 2026.
Para que posso usar dsh-blender-plugin?
Permitir que um agente de IA modele, ajuste e confira objetos em uma cena aberta no Blender. Executar varreduras de parâmetros para ajustar um modelo a uma silhueta de referência. Renderizar em lote ou processar geometria no Blender sem interface gráfica, mantendo a interface livre. Verificar folgas e interferências em montagens mecânicas antes da impressão 3D.
Como instalar dsh-blender-plugin?
Clone o repositório e entre no diretório: cd dsh-blender-plugin Instale-o como bundle em um perfil DSH (crie um link simbólico, adicione o link ao package.json do perfil e reinicie o DSH) Inicie o Blender, conecte o complemento DSH Blender Bridge incluído e verifique a instalação com o endpoint doctor: curl -sS http://127.0.0.1:9877/doctor
Onde consigo dsh-blender-plugin?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/sixtysevenlf/dsh-blender-plugin

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados