NOMOS

Seu agente. Sua máquina. Suas regras. — local por lei.

🌐 Site · ⚡ Instalar · 🖥️ Veja por dentro · 🔏 Verifique você mesmo · 🧭 Guia do iniciante · 📚 Docs

NOMOS é um agente pessoal de IA que roda 100% no seu computador. Cérebro,
memória, chaves e registros ficam na sua máquina. A nuvem é opcional e só
funciona se você "plugar" de propósito. Leve, sem exigir super-PC, e feito
para iniciantes.

E quando o NOMOS chega até você, chega provado: toda release publica hash, e
as recentes trazem proveniência criptográfica (SLSA/Sigstore) e inventário de
dependências — e dois
builds independentes do mesmo commit produzem wheel e sdist com o mesmo
sha256, verificado a cada CI por um gate bloqueante. A suíte roda em Linux,
macOS e Windows, em Python 3.10 a 3.13. Você não precisa confiar; pode
verificar.

███╗   ██╗ ██████╗ ███╗   ███╗ ██████╗ ███████╗
████╗  ██║██╔═══██╗████╗ ████║██╔═══██╗██╔════╝
██╔██╗ ██║██║   ██║██╔████╔██║██║   ██║███████╗
██║╚██╗██║██║   ██║██║╚██╔╝██║██║   ██║╚════██║
██║ ╚████║╚██████╔╝██║ ╚═╝ ██║╚██████╔╝███████║
╚═╝  ╚═══╝ ╚═════╝ ╚═╝     ╚═╝ ╚═════╝ ╚══════╝

Por que NOMOS

• 🔒 Local por lei — por padrão, nada sai da sua máquina. A própria política
  bloqueia qualquer saída para a internet até você permitir.
• 🧠 Cérebro leve embutido — não precisa de Ollama nem GPU. Baixa um modelo
  pequeno (a partir de ~400 MB) que roda em qualquer laptop, uma vez só.
• ✋ Pede licença — toda ação sensível passa por uma aprovação sua; em
  scripts/CI a resposta é sempre "não" (fail-closed, sem flag de bypass).
• 🎯 Nunca finge — sem cérebro conectado, avisa; jamais inventa resposta.
• 🧩 Skills governadas — habilidades instaláveis que só fazem o que
  declaram, com risco visível e aprovação humana.
• 🚦 Roteador automático — escolhe o melhor motor para cada tarefa,
  local primeiro, sem você precisar entender de modelos.
• 🔗 Cadeia de suprimentos provada — wheel e sdist bit-a-bit reproduzíveis,
  assinados via Sigstore, com SBOM amarrado por SHA-256 ao artefato exato.
• 🎨 Do seu jeito — nome do agente, personalidade e cores personalizáveis.

Capacidades

Veja por dentro

O painel roda só em 127.0.0.1, com URL secreta e zero assets externos —
nada sai da sua máquina nem para desenhar a página.

Cockpit — status, motores, memória e evidências numa tela	Aprovações — você decide; token de uso único, sem bypass
Dash ao vivo — saúde dos motores, sem telemetria externa	No celular — o mesmo painel, responsivo

Instalação (estado atual)

Requer Python 3.10+. Instalação a partir do código:

git clone https://github.com/Voltolini-SPACE/NOMOS
cd NOMOS
pip install .
nomos            # 1ª vez: assistente guiado; depois: menu principal

Ou pelos instaladores de 1 clique anexados a cada release do GitHub
(install.sh para Mac/Linux, install.ps1 para Windows) — com verificação de
integridade, backup automático e rollback. Detalhes: docs/INSTALL.md.

Verifique, não confie

Todo release do NOMOS publica três camadas independentes de garantia — e
qualquer pessoa pode conferir as três em menos de um minuto:

# 1. Integridade: os bytes que você baixou são os bytes publicados
shasum -a 256 -c SHA256SUMS

# 2. Proveniência: o pacote saiu DESTE repositório, DESTE workflow, DESTA tag
#    (assinatura Sigstore/Fulcio + transparência Rekor)
gh attestation verify nomos-*.whl -R Voltolini-SPACE/NOMOS

# 3. Reprodutibilidade: reconstrua do fonte e obtenha o MESMO hash
git checkout <tag> && python tools/repro_check.py

O inventário de dependências (sbom.cdx.json, CycloneDX 1.5) referencia o
wheel e o sdist pelo SHA-256 exato — o SBOM descreve aquele arquivo, não
"uma versão parecida". Contrato completo: docs/SUPPLY_CHAIN.md.

Comece por aqui

Dentro da conversa: /ajuda, /cerebro, /chaves, /motores, /tema,
/local, /doutor, /contexto (transparência do que vai ao motor), /sair.

O que o NOMOS nunca faz sem a sua permissão

Sair para a internet; usar motor de nuvem; usar chave do cofre; criar/alterar
arquivo; executar código; instalar skill; acessar microfone/câmera/tela.
Ações destrutivas são negadas por padrão. Detalhes e mecanismos:
docs/PRIVACIDADE.md.

Documentação

• Guia do iniciante — sem jargão
• Modelo de ameaças — cada garantia com o teste que a prova
• Instalação · Privacidade
• Motores · Roteador automático
• Conectores sociais — Telegram, WhatsApp, e-mail (o mapa honesto)
• Skills · Changelog

Como funciona

O NOMOS tem um kernel de governança (política fail-closed A0–A6, gate de
aprovação, cofre Argon2id, auditoria com cadeia de hash, cadeado de
localidade) e uma camada de cognição (cérebro embutido via llama.cpp,
memória local SQLite, catálogo de motores por modalidade, roteador automático
local-first e pipelines com política em cada etapa). Skills passam por
manifesto validado, checksum, assinatura ed25519 e trust store. Tudo em
Python puro, multiplataforma.

Motor Council

O Motor Council — um pipeline de múltiplos motores que revisa, julga e
arbitra respostas antes de entregá-las — está disponível em modo dry-run.
A capacidade estreou na tag v1.3.0rc4-motor-council-dry-run e segue presente,
sem retrocesso, na versão atual (1.3.0rc20). Ainda não é produção e
não executa motor de verdade.

Superfícies disponíveis hoje (nenhuma executa motor real):

nomos conselho ajuda                   # mapa dos comandos do Council
nomos conselho status                  # estado + travas (informativo)
nomos conselho modos [--avancado]      # os 4 modos (aceita --json)
nomos conselho diagnostico [--json]    # lê a trava REAL do harness, ao vivo
nomos conselho simular "seu texto"     # simulação segura (dry-run)
/conselho status                       # os mesmos, dentro do chat
/conselho modos
/conselho simular seu texto

Garantias atuais (todas verificadas por teste, não por convenção):

• Execução de motor real: desligada — trava literal
  REAL_LOCAL_ENGINE_EXECUTION_ENABLED = False, sem API para ativar.
• CLI e chat: status e modos são informativos puros (só imprimem
  fatos estáticos — nada de motor, prompt, rede ou disco); simular roda em
  dry-run; e perguntar, revisar, explicar, diagnostico — que
  exigiriam execução real — seguem desabilitados/fail-closed nas duas
  superfícies.
• Policy/Audit/Vault reais: não são chamados (o gate e o audit são só
  dry-run; A0–A6 simulado, would_write_audit=false).
• Nuvem / rede / subprocess: não usados por nenhum módulo do Council.
• Persistência: desligada no fluxo do Council.
• Prompt / conteúdo bruto: nunca aparece nas saídas (redação; só campos
  escalares seguros, inclusive no --json).
• Modo privado / paranoico: força persist_allowed=false.

Detalhes técnicos e o mapa completo das fases MC0–MC18:

• docs/architecture/MOTOR_COUNCIL_INDEX_v1.md — índice técnico
• docs/architecture/MOTOR_COUNCIL_UX_SPEC_v1.md — UX de CLI/chat
• docs/architecture/MOTOR_COUNCIL_CHAT_DRY_RUN_SPEC_v1.md — spec do chat dry-run

Maturidade

Release candidate (v1.3.0rc20, pre-release). Suíte com mais de 3.000 funções de
teste cobrindo segurança (fail-closed, não-vazamento de segredo, opt-in de nuvem)
e UX, rodando em 3 sistemas × 4 versões de Python — o estado de cada rodada é o
que o badge de CI acima mostra, não uma afirmação fixa aqui. As capacidades Git
governadas (C1/C2) exigem sandbox-exec e existem apenas no macOS; fora dele
o NOMOS recusa fail-closed, por desenho. Pedem opt-in separado por autoridade em
nomos orquestrar: --git (C1, leitura), --git-tag (C2a) e --git-tree
(C2c, git-add/git-commit), cada uma exigindo --raiz. O push (C2b) é o
único sem porta: seu destino é declarado pela política, e o policy.json
ainda não tem chave para declará-lo — --git-push existe e nega na porta, com
esse motivo. A cadeia de publicação tem
proveniência SLSA verificada, SBOM com amarração por hash e builds
bit-a-bit reproduzíveis com gate próprio no CI. O
Motor Council está em dry-run (ver seção acima): o subcomando simular
roda na CLI e no chat, mas sem execução de motor real, sem nuvem e sem
persistência. API interna pode mudar; os comandos da tabela acima são
estáveis.

Desenvolvimento

pip install -e .
python -m pytest -q          # suíte completa
ruff check src tests         # lint

Licença

MIT © Se7enpay