Frequently Asked Questions

Find answers to common questions about Imaginne v1.6.2 — Bombelli

What is Imaginne?
Imaginne is an autonomous AI agent for software development, strategic analysis and productivity. It runs as a TUI (terminal) and as a Desktop application (macOS and Windows). It reads your project, writes code, executes commands, generates presentations, and remembers decisions across sessions. Built by [N]umbers under the principle of AI Sovereignty — all provider keys stay server-side, never on your machine.
How do I install it?
Linux / macOS:
curl -fsSL https://imaginne.nnumbers.com.br/downloads/install.sh | bash
Windows (PowerShell as Admin):
irm https://imaginne.nnumbers.com.br/downloads/install.ps1 | iex
Ubuntu / Debian:
sudo curl -fsSL https://imaginne.nnumbers.com.br/apt-repo/imaginne-archive-keyring.gpg -o /usr/share/keyrings/imaginne.gpg
echo "deb [signed-by=/usr/share/keyrings/imaginne.gpg] https://imaginne.nnumbers.com.br/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/imaginne.list
sudo apt update && sudo apt install imaginne
Desktop (GUI): download from imaginne.nnumbers.com.br/desktop.
What AI models are available?
Imaginne offers three models via the [N]umbers infrastructure. Provider keys never leave the server.
ModelBest forCommand
[N]umbersGeneral purpose, fast — everyday coding, conversation, tasks/model nnumbers
[N]umbers R1Deep reasoning, chain-of-thought — complex debugging, architecture/model nnumbers-r1
[N]umbers CodeCode-focused with visible thinking — refactoring, analysis/model nnumbers-code
Switch anytime with /model or Ctrl+B. Context is preserved across model switches.
What are the keyboard shortcuts?
ShortcutFunction
F2 / Ctrl+CVoice toggle (start/stop)
Ctrl+QQuit
Ctrl+BSelect model
Ctrl+LReasoning level
Ctrl+AAutonomy level
Ctrl+XVerbose toggle
Ctrl+TTask panel
Ctrl+KClear screen
F1 / Ctrl+YHelp
Shift+TabToggle Plan mode
EscCancel generation / voice
PgUp/PgDnScroll output
What are the 3 operation modes?
Execute (/exe, default): Imaginne reads, writes and executes directly.
Plan (Shift+Tab): creates a plan first; you review and approve (Y), edit (E), iterate with another model (I) or reject (N).
Ask (/ask): read-only investigation — explores and reads files without modifying anything. Ideal for understanding unfamiliar code.
How does voice input work?
Press F2 or Ctrl+C to start recording. Speak naturally — the transcription appears in real-time in the input field. Press again to stop. Review the text and press Enter to send. Press Esc to cancel and discard.

Audio is streamed to [N]umbers servers for speech-to-text processing. No provider keys leave the server.

macOS: prompts for mic permission on first use. Windows: enable "Allow desktop apps to access microphone" in Settings → Privacy. Linux: works automatically if the audio system is available.
What are the autonomy levels?
LevelBehavior
lowAsks confirmation before every action (read, write, execute)
mediumReads freely, asks before writing files or executing commands
highFull autonomy — reads, writes and executes without asking
Change with /autonomy or Ctrl+A.
Is there a Desktop application?
Yes. Imaginne Desktop is available for macOS and Windows at imaginne.nnumbers.com.br/desktop. It provides a graphical interface with the same engine, model selector, voice input button, and i18n (EN/PT) support.
What are Core Skills (/strategy, /ppt)?
Core Skills are built-in commands that generate professional outputs:

/strategy swot "topic" — Strategic analysis with 9 frameworks: SWOT, Porter Five Forces, PESTEL, Blue Ocean, BCG Matrix, Ansoff Matrix, Value Chain, McKinsey 7S, Balanced Scorecard.

/ppt "topic" — Generate professional PowerPoint presentations. 278+ templates in 20+ categories (business, technology, finance, healthcare, education, marketing, etc.).
Where is my data stored?
~/.imaginne/config.yaml — Configuration and API key
~/.imaginne/memory/ — Session memory
.imaginne/ (project folder) — Workspace: PROJECT.md, RULES.yaml, MEMORY.md, skills/, hooks/, commands/
What security features exist?
Firewall: blocks operations on sensitive paths (.env, *.key, .git, node_modules). Configurable in RULES.yaml.
Policy: prevents file writes via shell redirections (>, >>, tee). Forces use of Write/Edit tools instead.
Autonomy: configurable per-session, limits what Imaginne can do without asking.
AI Sovereignty: all provider keys stay on [N]umbers servers. Your imn_xxx key authenticates against the gateway — it never touches a third-party API directly.
What does the logo [√-1] mean?
[√-1] represents the imaginary number i, the square root of -1. Considered impossible for centuries, imaginary numbers became essential to modern mathematics and engineering. The name Imaginne reflects this: turning the imaginary into reality. The codename Bombelli (v1.6.x) honors Rafael Bombelli, who in 1572 first systematized arithmetic with imaginary numbers in his treatise L'Algebra.
How do I report a bug?
Type /feedback or /fb inside Imaginne to submit a bug report directly.

Perguntas Frequentes

Respostas para as dúvidas mais comuns sobre o Imaginne v1.6.2 — Bombelli

O que é o Imaginne?
O Imaginne é um agente de IA autônomo para desenvolvimento de software, análise estratégica e produtividade. Roda como TUI (terminal) e como aplicativo Desktop (macOS e Windows). Ele lê seu projeto, escreve código, executa comandos, gera apresentações e lembra decisões entre sessões. Criado pela [N]umbers sob o princípio de Soberania de IA — todas as chaves de provedor ficam nos servidores, nunca na sua máquina.
Como instalar?
Linux / macOS:
curl -fsSL https://imaginne.nnumbers.com.br/downloads/install.sh | bash
Windows (PowerShell como Admin):
irm https://imaginne.nnumbers.com.br/downloads/install.ps1 | iex
Ubuntu / Debian:
sudo curl -fsSL https://imaginne.nnumbers.com.br/apt-repo/imaginne-archive-keyring.gpg -o /usr/share/keyrings/imaginne.gpg
echo "deb [signed-by=/usr/share/keyrings/imaginne.gpg] https://imaginne.nnumbers.com.br/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/imaginne.list
sudo apt update && sudo apt install imaginne
Desktop (GUI): baixe em imaginne.nnumbers.com.br/desktop.
Quais modelos de IA estão disponíveis?
O Imaginne oferece três modelos via infraestrutura da [N]umbers. Chaves de provedor nunca saem do servidor.
ModeloIdeal paraComando
[N]umbersUso geral, rápido — código, conversação, tarefas do dia a dia/model nnumbers
[N]umbers R1Raciocínio profundo, chain-of-thought — debugging complexo, arquitetura/model nnumbers-r1
[N]umbers CodeEspecializado em código com pensamento visível — refatoração, análise/model nnumbers-code
Troque a qualquer momento com /model ou Ctrl+B. O contexto é preservado.
Quais são os atalhos de teclado?
AtalhoFunção
F2 / Ctrl+CVoice toggle (iniciar/parar voz)
Ctrl+QSair
Ctrl+BSelecionar modelo
Ctrl+LNível de raciocínio
Ctrl+ANível de autonomia
Ctrl+XVerbose toggle
Ctrl+TPainel de tarefas
Ctrl+KLimpar tela
F1 / Ctrl+YAjuda
Shift+TabAlternar modo Plan
EscCancelar geração / voz
PgUp/PgDnNavegar saída
Quais são os 3 modos de operação?
Execute (/exe, padrão): o Imaginne lê, escreve e executa diretamente.
Plan (Shift+Tab): cria um plano primeiro; você revisa e aprova (Y), edita (E), itera com outro modelo (I) ou rejeita (N).
Ask (/ask): modo somente leitura — explora e lê arquivos sem modificar. Ideal para entender código desconhecido.
Como funciona a entrada por voz?
Pressione F2 ou Ctrl+C para iniciar a gravação. Fale naturalmente — a transcrição aparece em tempo real no campo de entrada. Pressione novamente para parar. Revise o texto e envie com Enter. Pressione Esc para cancelar e descartar.

O áudio é processado nos servidores da [N]umbers via speech-to-text. Nenhuma chave de provedor sai do servidor.

macOS: pede permissão de microfone no primeiro uso. Windows: ative "Permitir apps desktop acessarem o microfone" em Configurações → Privacidade. Linux: funciona automaticamente se o sistema de áudio estiver disponível.
Quais são os níveis de autonomia?
NívelComportamento
lowPede confirmação antes de qualquer ação (ler, escrever, executar)
mediumLê livremente, pede antes de escrever arquivos ou executar comandos
highAutonomia total — lê, escreve e executa sem perguntar
Altere com /autonomy ou Ctrl+A.
Existe aplicativo Desktop?
Sim. O Imaginne Desktop está disponível para macOS e Windows em imaginne.nnumbers.com.br/desktop. Possui interface gráfica com o mesmo engine, seletor de modelos, botão de voz e i18n (EN/PT).
O que são Core Skills (/strategy, /ppt)?
Core Skills são comandos integrados que geram outputs profissionais:

/strategy swot "tema" — Análise estratégica com 9 frameworks: SWOT, Porter, PESTEL, Blue Ocean, BCG Matrix, Ansoff, Value Chain, McKinsey 7S, BSC.

/ppt "tema" — Gera apresentações PowerPoint profissionais. 278+ templates em 20+ categorias (negócios, tecnologia, finanças, saúde, educação, marketing, etc.).
Onde meus dados são armazenados?
~/.imaginne/config.yaml — Configuração e chave API
~/.imaginne/memory/ — Memória de sessão
.imaginne/ (pasta do projeto) — Workspace: PROJECT.md, RULES.yaml, MEMORY.md, skills/, hooks/, commands/
Que recursos de segurança existem?
Firewall: bloqueia operações em caminhos sensíveis (.env, *.key, .git, node_modules). Configurável via RULES.yaml.
Policy: impede escrita de arquivos via redirecionamentos do shell (>, >>, tee). Força o uso de ferramentas Write/Edit.
Autonomia: configurável por sessão, limita o que o Imaginne pode fazer sem perguntar.
Soberania de IA: todas as chaves de provedor ficam nos servidores da [N]umbers. Sua chave imn_xxx autentica contra o gateway — nunca toca uma API de terceiro diretamente.
O que significa o logo [√-1]?
[√-1] representa o número imaginário i, a raiz quadrada de -1. Considerado impossível por séculos, os números imaginários se tornaram essenciais para a matemática e engenharia modernas. O nome Imaginne reflete isso: transformar o imaginário em realidade. O codinome Bombelli (v1.6.x) homenageia Rafael Bombelli, que em 1572 sistematizou pela primeira vez a aritmética com números imaginários em seu tratado L'Algebra.
Como reportar um bug?
Digite /feedback ou /fb dentro do Imaginne para enviar um relatório de bug diretamente.