O NeuroBrix assenta em três invariantes de design invioláveis que garantem um comportamento previsível, depurável e universal.
Nenhum valor fixo no código em todo o runtime.
Todos os valores vêm de ficheiros de configuração:
topology.json — fluxo de execução e ligações entre componentescomponents/<name>/runtime.json — configuração de execução do componentecomponents/<name>/graph.json — grafos de cálculo de tensoresdefaults.json — parâmetros ajustáveis pelo utilizador (passos, guidance, temperature)hardware/<profile>.yml — configurações de GPUConstantes inline como sample_size = 128 são proibidas. Isto significa que o mesmo código de runtime trata a geração de imagem, os LLMs, o áudio e os modelos de vídeo sem qualquer lógica específica de modelo.
Dados em falta = falha explícita, nunca valores predefinidos silenciosos.
Se um valor de configuração obrigatório estiver em falta, o NeuroBrix falha de imediato com uma mensagem de erro clara que explica exatamente o que falta e onde deveria estar definido.
"Explicit errors allow for fast debugging. A default value can mask a bug for weeks."
Isto é intencional: os valores de recurso silenciosos são a origem de problemas difíceis de depurar em produção. Um modelo que "quase funciona" é pior do que um modelo que falha claramente com erros acionáveis.
O runtime conhece tensores, não domínios.
O runtime do NeuroBrix não tem qualquer conceito de "imagem", "texto", "áudio" ou de qualquer outro domínio. Opera sobre tensores abstratos:
Tensor [B, C, H, W]Tensor [B, SeqLen]float escalarTodo o comportamento específico de um domínio está codificado na topologia e nos grafos de componentes do contentor .nbx. É isto que torna o NeuroBrix verdadeiramente universal — o mesmo runtime trata qualquer modalidade.
Estes três princípios funcionam em conjunto:
O resultado: execução universal entre famílias de modelos sem modificações, mensagens de erro precisas, comportamento previsível sem caminhos de código ocultos e zero alterações ao runtime quando se adicionam novos modelos.
Seguinte: Hub de Modelos