| Requisito | Quando é necessário |
|---|---|
| Node.js 20 ou superior, com npm | Instalar, compilar e executar. Mínimo definido em package.json; os exemplos de instalação usam Node 24. |
Git no PATH | Projetos Git, clones, diffs e worktrees. |
| Bash e ambiente POSIX | Runner shell padrão (/bin/bash) e fluxo completo de terminais. No Windows, use WSL2. |
Python 3 como python3, com módulos POSIX | Terminais reais sem instalar node-pty; recomendado no Linux, macOS e WSL. |
| Navegador com JavaScript e WebSocket | Interface web. |
| Pasta gravável pelo seu usuário | Código, estado .cockpit/, registros e worktrees. |
| Internet | Download de dependências, modelos de voz, plugins e uso de provedores remotos. |
| CLI de IA instalado e autenticado | Tarefas com IA; o shell local funciona sem provedor. |
O Cockpit tenta terminais nesta ordem: node-pty, ponte Python POSIX, pipes. node-pty não é uma dependência declarada e não é obrigatório quando a ponte Python funciona. Pipes não oferecem TTY real nem resize efetivo e podem prejudicar CLIs interativos.
#O que não é obrigatório
- Docker, PostgreSQL, Redis ou um servidor SQLite separado.
- Cockpit, DeepSeek Harness, Ollama ou Obsidian.
- Todos os provedores, todas as skills ou ferramentas de mídia.
- TypeScript, Vite ou React globalmente: npm instala as ferramentas do projeto.
- GPU para a transcrição padrão, que usa CPU.
Não há chave universal de API obrigatória para iniciar o painel. Cada provedor tem sua autenticação, cotas e cobrança; instalar o Cockpit não concede acesso aos modelos.
#O que evitar
- Rodar o servidor como root/administrador para contornar permissões.
- Misturar Node/npm/CLIs do Windows com os instalados dentro do WSL.
- Copiar
node_modulesentre sistemas ou arquiteturas; reinstale comnpm ci. - Versionar tokens, credenciais,
.env, estado de sessões ou arquivos do cofre. - Apagar
.cockpit/e worktrees sem backup para tentar corrigir um erro. - Tratar worktrees como sandbox de segurança: os processos continuam com as permissões do seu usuário.
Não existe mínimo de RAM/disco homologado no repositório. O consumo depende da equipe, projetos, plugins e modelos locais; comece com poucos agentes e acompanhe o uso da máquina.