Instalação

O Imaginne tem quatro superfícies. Três delas rodam o agente localmente na sua máquina (Desktop, Terminal e VS Code) e uma roda no servidor (o chat no navegador). Esta página ajuda você a escolher e aponta para o guia de cada uma.

Pré-requisito comum: uma conta na organização

Todas as superfícies usam o login da sua organização. Se você ainda não tem acesso, peça a um administrador para criar o seu usuário no console — você receberá um e-mail para definir a senha. Não há cadastro avulso, e a criação do usuário não gera nenhuma chave de API: a autenticação é sempre pelo navegador. Veja Identidade & login.

As quatro formas de usar

🖥️Desktop

Aplicativo nativo para macOS e Windows. A experiência mais completa.

Instalar Desktop →⌨️Terminal (TUI)

O agente inteiro dentro do seu terminal, via um único binário.

Instalar TUI →🧩VS Code

Uma extensão que traz o agente para dentro do editor.

Instalar extensão →🌐Chat no navegador

Nada para instalar — acesse e comece a conversar.

Abrir o chat →

Tabela comparativa

Superfície	O que instalar	Sistema operacional	Melhor para
Desktop	App nativo (.dmg / instalador)	macOS, Windows	Uso diário com voz, rotinas, sessão remota e visualização de artefatos.
Terminal (TUI)	Binário imaginne (via install.sh)	macOS, Linux, Windows	Quem vive no terminal; automações e fluxo orientado a teclado.
VS Code	Extensão nnumbers.imaginne + o CLI imaginne	macOS, Linux, Windows	Desenvolvedores: editar, testar e revisar código sem sair do editor.
Chat no navegador	Nada	Qualquer um com navegador	Acesso rápido, máquina emprestada, trabalho com anexos e projetos sem instalar nada.

Local vs. servidor

Nas superfícies de app (Desktop, Terminal, VS Code), o Engine roda na sua máquina: os arquivos ficam locais e só o conteúdo do prompt é enviado. No chat web, o agente roda no servidor. Entenda a diferença em Execução local e Arquitetura.

Desktop, Terminal e VS Code executam localmente; o chat no navegador executa no servidor. Em todos os casos, o Gateway é o único elo com o provedor de modelos.

Canais: PROD e DEV

Existem builds separados para dois ambientes. Use o que a sua organização indicar.

Canal	Aponta para	Pasta de configuração
PROD (padrão)	ai.nnumbers.com.br	~/.imaginne/
DEV	ambiente de validação da organização	~/.imaginne-dev/

Os dois canais não compartilham configuração nem sessão — o build DEV grava em ~/.imaginne-dev/, totalmente isolado do PROD. Isso permite manter as duas versões instaladas lado a lado. Cada guia de instalação detalha como obter o canal correto (sufixo -dev no instalador da TUI, na extensão e no app).

Não sabe qual usar?

Se ninguém pediu o contrário, use PROD. O canal DEV existe para validação e adoção antecipada, e pode conter recursos ainda em estabilização.

Próximos passos

Escolha a sua superfície e siga o guia. Se quiser ver tudo funcionando de ponta a ponta primeiro, comece pelo Início rápido.

🖥️Instalar Desktop

macOS e Windows, com atualização automática.

Abrir →⌨️Instalar TUI

Um comando para instalar o binário imaginne.

Abrir →🧩Instalar VS Code

Extensão + CLI local.

Abrir →🚀Início rápido

Do download à primeira tarefa em minutos.

Abrir →