Pular para o conteúdo principal

Arquitetura

Esta página explica como o Imaginne é montado, em linguagem para usuários e administradores — sem entrar em detalhes de infraestrutura.

Visão geral​

Superfícies conversam com o Engine; o Engine fala com o Gateway (modelos) e a Platform (identidade e política); o Gateway fala com o modelo.
As quatro superfícies, o Engine (o agente), o Gateway (modelos) e a Platform (controle).

O Imaginne tem quatro partes que importam para você:

  • Superfícies — Desktop, terminal (TUI), VS Code e chat no navegador. É por onde você fala com o agente. Elas são "apenas" a interface: todo o raciocínio acontece no Engine.
  • Engine — o agente. Ele interpreta o seu pedido, decide quais ferramentas usar (ler/escrever arquivos, rodar comandos, acionar skills), conduz a conversa em turnos e produz a resposta. O Engine é o mesmo, rode ele na sua máquina ou no servidor.
  • Gateway — o corretor de modelos. É o único componente autorizado a falar com o fornecedor de modelo.
  • Platform — o plano de controle: identidade (quem é você), política (o que a sua organização permite), governança de skills e o relay para sessões remotas. A Platform não executa suas ferramentas e não vê seus arquivos.
Regra de ouro

O Engine nunca chama o modelo diretamente — sempre pelo Gateway. E o Gateway é o único que fala com o fornecedor de modelo. Isso concentra credenciais, política de modelo e medição em um só lugar.

O caminho de uma mensagem​

Você escreve um pedido; a superfície entrega ao Engine local; o Engine resolve política com a Platform e chama o Gateway, que chama o modelo; a resposta volta em streaming.
Da sua mensagem até o modelo e de volta — em streaming.
  1. Você escreve um pedido na superfície.
  2. A superfície entrega ao Engine.
  3. O Engine resolve a política vigente com a Platform (quais modelos e skills você pode usar) e monta o contexto (sua mensagem, arquivos relevantes, memória do projeto).
  4. O Engine chama o Gateway, que chama o modelo.
  5. A resposta volta em streaming. Se o agente decidir usar uma ferramenta (editar um arquivo, rodar um comando, acionar uma skill), ele faz isso localmente — pedindo confirmação conforme a sua autonomia.

Onde o agente roda​

Local-first nas superfícies de aplicativo; hospedado no chat web.
Duas topologias, o mesmo Engine.
  • Local-first (Desktop, terminal, VS Code). O Engine roda na sua máquina. Ele lê e escreve nos seus arquivos, executa comandos no seu shell e roda as skills localmente. Apenas o conteúdo que o modelo precisa ler sai da máquina, em direção ao Gateway.
  • Hospedado (chat no navegador). Como não há nada instalado, o mesmo Engine roda nos servidores do Imaginne. A Platform autentica e faz o relay do streaming entre o navegador e o Engine.

As consequências disso para privacidade estão em Execução local & privacidade.

Por que essa separação importa​

  • Você trabalha onde os arquivos estão — sem exportar e colar.
  • A organização tem um ponto único de controle — a Platform decide a política; o Gateway aplica credenciais e medição.
  • Trocar de modelo não muda o produto — as superfícies e o Engine falam com nomes lógicos (nnumbers, nnumbers-code); o fornecedor de modelo por trás pode mudar sem afetar você. Veja Modelos.

Continue lendo​

Execução local & privacidade

O que sai da sua máquina e o que fica.

Abrir →Identidade & login

O token único que vale em todo lugar.

Abrir →Organizações & políticas

Como a sua organização governa o agente.

Abrir →

Próximos passos​