Pular para o conteúdo principal

Execução local & privacidade

Uma das ideias centrais do Imaginne é local-first: nas superfícies de aplicativo, o agente trabalha na sua máquina. Esta página detalha o que isso significa na prática e o que de fato sai do seu dispositivo.

O que roda localmente​

No Desktop, no terminal (TUI) e no VS Code:

  • O Engine (o agente) roda no seu computador.
  • As ferramentas rodam localmente: ler/escrever arquivos, rodar comandos, acionar skills.
  • As skills são executadas na sua máquina, a partir de ~/.imaginne/skills/ e do .imaginne/skills/ do projeto.
  • A sessão (histórico, ações, estado) e a memória do projeto ficam em arquivos locais no seu projeto/usuário.

O que sai da sua máquina​

Apenas o conteúdo do prompt — ou seja, o que o modelo precisa "ler" para responder — é enviado, e somente ao Gateway. Isso inclui a sua mensagem e, quando relevante, trechos de arquivos que o agente decidiu colocar no contexto.

  • Os arquivos em si não são enviados pelas superfícies locais. O agente lê o conteúdo localmente e envia ao modelo apenas o que for necessário para a tarefa.
  • O Gateway é o único componente que fala com o fornecedor de modelo.
O chat no navegador é diferente

No chat web, como não há nada instalado, o agente roda nos servidores do Imaginne. Ali, o conteúdo da sessão trafega e é processado no servidor. Se a sua exigência é "nada sai da máquina", use o Desktop ou a TUI.

Redução de segredos e dados pessoais​

Antes de enviar o conteúdo ao modelo, o Imaginne aplica um verificador de conteúdo que reconhece e substitui por marcadores padrões sensíveis conhecidos — e‑mails, telefones, CPF/CNPJ, cartões, tokens de sessão, chaves de nuvem e chaves privadas PEM. O texto correspondente não é registrado em log.

Trate isso como uma camada de defesa, não como uma garantia absoluta: é uma proteção contra vazamento acidental dos padrões reconhecidos, e não um substituto para o bom senso ao compartilhar dados muito sensíveis.

Onde ficam os seus dados (superfícies locais)​

DadoOnde fica
Sessões / históricoArquivos locais do projeto (com um índice local).
Memória do projeto<projeto>/.imaginne/memory/*.md.
Skills~/.imaginne/skills/ (globais) e <projeto>/.imaginne/skills/ (do projeto).
Configuração e token de sessão~/.imaginne/config.yaml.
Artefatos geradosA pasta de saída do projeto (por padrão outputs/).
Estado local não é criptografado

Sessões e memória ficam em arquivos legíveis no seu disco — a mesma postura de qualquer projeto local. Proteja a sua máquina como você já protege seu código e seus documentos.

O que isso garante para a sua organização​

  • Soberania dos arquivos. Em Desktop/TUI/VS Code, os arquivos não são enviados; só o conteúdo necessário ao modelo trafega.
  • Ponto único de saída. Todo o tráfego de modelo passa pelo Gateway, onde a organização aplica credenciais e medição.
  • Credenciais sob controle. Você não manuseia chaves de fornecedor; segredos de skills são injetados de forma restrita (veja Env-secrets).

Aprofunde​

Próximos passos​