Nebuloso Beta
Agente de terminal para programação e modelagem no Blender. A interface é uma TUI interativa, com painel de integrações, histórico de conversa e comandos com autocomplete. A configuração fica somente no ambiente local.
Rodar
Requer Bun (o OpenTUI/Solid não funciona com o Node 24 atual). Instale as dependências uma vez:
bun install
Você pode integrar a API diretamente no Nebuloso, sem definir variável de ambiente. No console, use:
/integrar-api
A tela solicitará a chave da API do Nebuloso. A chave é salva somente em .nebuloso/config.json (já ignorado pelo Git).
$env:NEBULOSO_API_KEY = "sua-chave"
bun run start
Para conectar um servidor MCP do Blender que use stdio, defina o comando que você já usa para iniciá-lo:
$env:NEBULOSO_BLENDER_MCP_COMMAND = "comando-do-seu-servidor-mcp"
node .\nebuloso-ui.js
O histórico fica em .nebuloso/history.json, nunca é enviado intencionalmente exceto como contexto da conversa. Use /novo para apagar o contexto atual.
Comandos
/ajuda, /integrar-api, /status, /novo, /limpar e /sair. Ao digitar /, os comandos compatíveis aparecem acima do campo; Tab completa o primeiro resultado.
Banco e licenças
Crie um arquivo .env local com DATABASE_URL (use .env.example como modelo). O banco armazena usuários, licenças por hash e consumo; chaves de API não são salvas nele.
Depois de configurar o banco, crie uma licença para um usuário:
bun run db:setup
bun run license:issue NB-1977 30
O segundo argumento é a validade em dias (30 no exemplo). Copie a licença exibida e cole-a na tela inicial do Nebuloso; o Nebuloso cria um ID de usuário único e vincula a licença a ele automaticamente.
Para gerar uma licença de teste de 25 minutos, use:
bun run license:trial
O comando imprime uma chave aleatória NBT-.... Se necessário, informe uma chave específica como primeiro argumento: bun run license:trial NBT-CLIENTE-TESTE.
No HeidiSQL, consulte SELECT * FROM nebuloso_license_dashboard; para ver usuários, validade e consumo da janela de 3 horas. Uma licença recém-vinculada começa em 0/50; cada chamada ao agente é registrada automaticamente.
Versão clássica
Caso precise do modo simples, sem a interface em tela cheia: npm.cmd run start:classic.