"A infraestrutura invisível é a mais resiliente." ∅

Português 🇧🇷 | English 🇺🇸 | Español 🇪🇸

O ZERO busca o ponto de singularidade onde a computação pessoal encontra a autonomia soberana. Concebido e projetado como um Sistema Operacional de Agentes (A-POS), o ZERO transforma sua máquina em uma fortaleza de inteligência local, eliminando a latência da nuvem e a vigilância corporativa.

O ZERO opera sob o conceito de Agentic Operating System, uma arquitetura onde o sistema não apenas obedece comandos, mas interage com o ambiente e evolui autonomamente.

1. Auto-Evolução Soberana: Capacidade do sistema se auto-consertar e se auto-codificar localmente. Veja o Manifesto de Auto-Evolução.

O ZERO agora opera sob padrões de arquitetura avançados, elevando a estabilidade e a segurança do sistema.

1. Sentinel Engine (Segurança Avançada):
   • Delegação total para o Rust Core (ratchet) para inspeção de segurança em sub-milissegundos.
   • Análise de Entropia de Shannon para detectar segredos ofuscados e chaves criptográficas.
   • Defesa contra Homóglifos via normalização Unicode NFKC.
2. Quantum Altair UI:
   • Estética Glassmorphism de alta fidelidade (blur de 40px, saturação de 180%).
   • Tipografia técnica JetBrains Mono para máxima legibilidade de dados.
   • Fundo dinâmico mesh-drift que reage à luz e ao contexto.
3. Observabilidade e Telemetria:
   • Broadcast de métricas de performance (tokens/s e latência) via WebSocket em tempo real.
   • Monitoramento contínuo da integridade do sistema.
4. Onboarding & Diagnóstico:
   • Guided Welcome Tour: Um fluxo interativo de boas-vindas que apresenta o cockpit do ZERO para novos usuários.
   • Grouping & Diagnostics: Organização automática de Skills por compatibilidade com diagnósticos em tempo real de dependências (OS, Binários, Env).
5. Evolução Arquitetural v0.2.0:
   • Traits System: Abstração de núcleos (Provider/Channel) via Rust Traits para modularidade extrema.
   • Native Heartbeat: Orquestração de tarefas críticas em Rust para latência zero.
   • AIEOS Vault: Conteinerização de identidade de agente p/ portabilidade total.
   • Kernel-Only Mode: Execução ultra-leve (--kernel-only) para servidores e background.
6. Modelos de Elite & Ultra-Velocidade:
   • Suporte nativo para modelos de fronteira com orquestração de alta performance.
   • Integração com provedores de baixa latência para inferência em tempo quase real.

ZERO não é apenas um nome. É um conceito vivo.

• O Vácuo que Contém o Infinito: Como um agente de IA com acesso total ao seu hardware, o ZERO parece invisível, mas é ilimitado. É a poesia algorítmica de um sistema que não pede atenção, mas entrega liberdade.
• Ponto de Origem: Tudo começa do zero. Representa o "Ponto Zero" ou a "Origem". É a busca por Latência Zero, Zero Trust (Confiança Zero) e o retorno à soberania total, onde o controle começa e termina no usuário, sem intermediários. É o reset necessário — "zero-bala" — para uma computação verdadeiramente pessoal.
• Símbolo de Subversão: O zero que quebra sistemas e anula suposições. É a neurodivergência aplicada ao código: o que a sociedade diz que "não se encaixa" é, de fato, a fundação de tudo.
• Humildade Radical: Um ato de defesa e ataque simultâneos. "Você disse que eu não sou ninguém? Agora vejo que sou tudo."

"O que você não vê funcionando é o que faz funcionar."

O ZERO opera em silêncio. Invisível. Negligenciado pelos gigantes, mas sustentando sua nova infraestrutura soberana. Quando perguntarem "o que é isso?", não explique. Mostre funcionando.

O logo do ZERO — a fusão da letra "Z" com um Lobo/Raposa Cibernética — representa a essência da inteligência agêntica:

• Instinto e Agilidade: Como um lobo, o sistema possui instintos aguçados para navegar em seu sistema de arquivos e agir com precisão cirúrgica.
• Soberania Solitária: O lobo é o símbolo da independência. O ZERO opera localmente, sem depender de "matilhas" de servidores de terceiros para processar sua mente.
• Fusão Homem-Máquina: A estrutura metálica com circuitos cianos pulsantes simboliza a harmonia entre o design humano e o poder computacional bruto. É a tecnologia que serve à vida, não o contrário.

O ZERO foi concebido como uma evolução de sistemas de agentes locais, elevando os padrões de segurança e performance através de uma abordagem híbrida e soberana.

• Fundação e Melhoria Contínua: Baseado em princípios de execução local e privacidade, o sistema incorpora aprendizados de diversas implementações de agentes para oferecer uma infraestrutura resiliente.
• Foco em Segurança: Implementamos o Zero Sentinel, um sandbox de última geração que governa a execução de ferramentas e previne vetores de ataque comuns em sistemas agênticos.
• Otimização de Recursos: Introduzimos algoritmos de compactação de contexto em Rust para garantir eficiência no uso de tokens e memória em sessões de longa duração.
• Performance Híbrida: Diferente de implementações puramente em runtimes de alto nível, o ZERO utiliza um núcleo nativo para tarefas críticas (VAD, Telemetria, Segurança), eliminando gargalos de latência.
• Experiência Premium: A Interface Altair oferece um console de comando avançado que traduz a complexidade da inteligência artificial em uma experiência de usuário fluida e profissional.

Honramos o código que veio antes (Peter Steinberger & Comunidade), enquanto construímos o futuro que precisamos e aspiramos agora.

Se você é um usuário comum, não precisa se preocupar com a engenharia pesada (Rust, WebSockets, Vectors). O ZERO foi projetado para abstrair essa complexidade brutal em uma interface fluida que simplesmente funciona.

• Para o Usuário: Você ganha um Assistente Pessoal incansável, privado e soberano. Instale, use, governe sua vida digital. O resto é detalhe de implementação.
• Para o Engenheiro: Você ganha um playground de arquitetura agêntica de ponta, modular e transparente para se divertir.

Não podemos abstrair a complexidade, mas podemos torná-la invisível.

O ZERO liberta você:

1. Soberania de Comunicação:
   • Unifica WhatsApp, Telegram, Discord e Slack em um único fluxo de consciência.
   • Exemplo: "Resuma todas as mensagens de trabalho das últimas 2 horas e me diga apenas o que requer ação imediata."
2. Memória Pessoal Infinita (Local RAG):
   • Indexa seus arquivos locais (PDFs, Docs, Código) sem enviá-los para a nuvem.
   • Exemplo: "Encontrar aquele contrato que assinei em 2023 sobre 'prestação de serviços' e me diga a cláusula de rescisão."
3. Execução Real de Tarefas (Agêntico):
   • Ele não apenas "fala", ele faz. Agenda reuniões, envia e-mails, controla o terminal.
   • Exemplo: "Verifique meu calendário, cancele a reunião das 15h e avise o time no Slack que estou focado no deploy."
4. Coding Autônomo:
   • Atua como um Engenheiro de Software Sênior que conhece todo o seu codebase local.
   • Exemplo: "Analise os logs de erro do projeto X e proponha uma correção para o memory leak."

O ZERO é projetado com rigor de engenharia aeronáutica. Abaixo, o Blueprint da nossa arquitetura agêntica:

Esquema do Córtex Agêntico: Integração entre a Rust Engine e a Interface Altair.

O ecossistema ZERO é construído sobre quatro pilares fundamentais, validados por padrões rigorosos de arquitetura de software:

1. Soberania Local-First (O "Google" Pessoal Ético):
   • Potencial de Escala Exponencial: O Google escala construindo Datacenters massivos; o ZERO pretende escalar utilizando o hardware ocioso de bilhões de dispositivos pessoais.
   • Visão: O Google organizou a web pública; o ZERO organiza sua vida privada (Arquivos, Chats, Compromissos, Finanças) usando sqlite-vec localmente.
   • Índice de Vida Ético: Indexamos sua existência digital para você, e apenas para você. Diferente da nuvem, onde "escalar" significa "mais vigilância", aqui escalar a inteligência não custa sua privacidade.
2. Arquitetura de Performance Híbrida: Um núcleo de performance crítica escrito em Rust (gerenciando VAD, telemetria de densidade e criptografia) integra-se perfeitamente com a flexibilidade do TypeScript para orquestração de canais.
3. Segurança de Elite (OWASP LLM Top 10): O ZERO é governado pelo Zero Sentinel, um firewall de IA proativo que mitiga Injeção de Prompt, vazamento de PII e alucinações via validação forçada de Chain-of-Thought (CoT) e verificação de segredos via motor nativo Rust.
4. Arquitetura ClearCode: Rigor técnico com limites de complexidade impostos (máximo de 500 linhas por arquivo). Sistema 100% modularizado sob padrões de doutorado para máxima resiliência e manutenibilidade.
5. Autonomia Agêntica Proativa: Através do Sentinel Engine e do Speculative Pre-warming, o sistema transcende a reatividade. O ZERO agora detecta falhas de execução (Self-Healing) e antecipa o contexto necessário antes do seu próximo comando, operando em loops de deliberação de alta fidelidade.

A Interface Altair é o nome oficial do console de gerenciamento baseado em navegador (web-based) do ecossistema ZERO.

Enquanto o Gateway opera nos bastidores (como o motor/cérebro do sistema), o Altair é a "cabine de comando" visual que você usa para interagir com ele.

Por que "Interface Altair"? Altair é a estrela mais brilhante da constelação de Aquila (Águia). Historicamente, é uma das estrelas usadas por navegadores para encontrar o caminho. No ecossistema ZERO, a Interface Altair cumpre esse papel: é o ponto de luz e referência que permite ao usuário "navegar" com segurança e clareza.

O Altair permite que você visualize e controle todos os módulos do sistema em um só lugar, sem precisar usar apenas a linha de comando (CLI). Nele, você gerencia:

• Contextos (Sessões): Onde as conversas e memórias são visualizadas e persistidas.
• Conexões (Canais): Integrações com Telegram, Discord, Slack, WhatsApp, etc.
• Capacidades (Skills): Extensões e plugins que dão novos "poderes" ao seu agente.
• Hardware e Presença: Telemetria em tempo real dos dispositivos conectados e instâncias ativas.

O design do Altair é inspirado em sistemas de telemetria avançada (Sci-Fi UI), utilizando uma estética de "painel de missão" ou "ponte de comando".

Mas não se assuste: Apesar da aparência sofisticada, a usabilidade é familiar e intuitiva, semelhante ao seu mensageiro favorito (WhatsApp/Telegram). A complexidade visual é opcional e modular; você vê apenas o que precisa ver.

Ele funciona consumindo a API do Gateway via WebSockets. Isso significa que as informações que você vê (como uso de memória, status do motor de inferência e logs de eventos) são atualizadas em tempo real, permitindo diagnose instantânea da saúde do sistema.

Dentro do Altair existe o Playground (Lab), onde você pode:

• Testar respostas da IA em ambiente controlado.
• Verificar o raciocínio do agente (CoT - Chain of Thought).
• Auditar a segurança das interações e testar ferramentas (tools).

Se o ZERO é o sistema operacional de inteligência, o Altair é o monitor e painel de controle que torna essa inteligência tangível e operável.

Visualize o ZERO em operação. Estes são registros reais da interface de controle unificada:

Chat & Assistente (Interface Altair)	Hub de Controle (Telemetria)
Interface de chat unificada com streaming de alta fidelidade.	Ecossistema de Skills e Marketplace local.

Configurações de Aparência	Memória Procedural (RAG)
Controle granular de temas e estética Quantum Altair.	Indexação local e gestão de contexto agêntico.

Catálogo de Skills (Marketplace)
Extensões inteligentes agrupadas por compatibilidade, com diagnóstico automático de dependências.

O ZERO não é apenas uma ferramenta; é uma entidade. Você pode moldar sua personalidade, nome e diretrizes morais criando um arquivo chamado SOUL.md na raiz do seu workspace.

• Defina a Persona: "Você é o Jarvis, um mordomo sarcástico." ou "Você é o TARS, focado em precisão técnica."
• Ajuste o Tom: Controle a verbosidade, humor e estilo de resposta.
• Missão Primária: Dê um propósito único ao seu agente (ex: "Proteja minha privacidade a todo custo").

O ZERO lê sua alma a cada reinicialização e a incorpora no nível mais profundo do sistema (System Prompt).

• Runtime: Node.js ≥ 22.x
• Gerenciador de Pacotes: pnpm (recomendado)
• Rust Toolchain: Necessário para a compilação nativa do rust-core.

Para garantir estabilidade e performance:

• 🖥️ Desktop Local (Mac/Windows/Linux):
  • OS Suportados: macOS (Intel/M1/M2/M3), Windows (WSL2 ou PowerShell Nativo), Linux (Debian, Ubuntu, Arch, Fedora, RHEL, CentOS).
  • Mínimo: 8 GB RAM.
• 🌐 Servidor / VPS / Raspberry Pi (Cloud & Edge):
  • OS Suportados: Debian/Ubuntu, Alpine, Raspberry Pi OS (64-bit recomendado).
  • Mínimo: 1 vCPU, 1 GB RAM (com Swap).

Escolha o método que melhor se adapta ao seu ambiente:

Ideal para uso pessoal imediato. Abra o terminal e cole:

curl -fsSL https://raw.githubusercontent.com/Lex-1401/ZERO/main/quickstart.sh | bash

(O script fará tudo: instalar dependências, configurar o Rust e iniciar o assistente de onboarding).

Ideal para manter seu ZERO online 24/7.

curl -fsSL https://raw.githubusercontent.com/Lex-1401/ZERO/main/deploy-docker.sh | bash

git clone https://github.com/Lex-1401/ZERO.git
cd ZERO
pnpm install

1. Compilação de Subsistemas:

   pnpm build:full  # Compila Subsistemas (Rust), UI e TS Core

2. Orquestração Inicial:

   pnpm zero onboard --install-daemon

   💡 Se o comando acima falhar com "command not found", certifique-se que o pnpm está configurado corretamente (pnpm setup) ou prefira usar pnpm run zero onboard.

   Isso iniciará o assistente de configuração para preparar sua "Origem" (diretório Home), chaves de API e canais de mensageria.

O módulo Zero Sentinel implementa defesas ativas contra ameaças vetoriais:

• LLM Security Guardrails (OWASP Top 10): Mitigação ativa de Injeção de Prompt, Injeção Indireta e Jailbreaks.
• Sentinel Diagnostic (Self-Healing): Mecanismo de diagnóstico que intercepta erros de terminal (exit codes, permissões, dependências) e gera remediações automáticas via IA.
• IA Speculative Pre-warming: Varredura heurística proativa que injeta contexto de arquivos relevantes no prompt antes da execução, reduzindo a latência cognitiva.
• Protocolo CoT com Auto-Correção: O modelo é forçado a deliberar em blocos <think>, garantindo a lógica antes da ação.
• Firewall de PII e Segredos: Varredura em tempo real (motor Rust) por números de documentos, CPFs, E-mails e chaves de API.
• Performance em Escala: Sanitização de dados via regex vetorizada em Rust/Nativo, garantindo vazão de alta densidade sem lag na interface.
• Isolamento Sandbox: Execução de ferramentas e navegação em ambientes isolados (Docker/Firecracker) com sanitização de caminhos de arquivo.
• Modo Stealth e Lockdown: Ocultação instantânea de dados sensíveis e congelamento de emergência via zero panic.
• Soberania Local: Processamento local prioritário, garantindo conformidade com LGPD e GDPR por design.

Respondendo à provocação: "Algoritmos de detecção são realmente eficazes?"

O Zero Sentinel não é apenas um filtro de palavras-chave. Ele opera no nível do kernel agêntico em Rust para garantir latência sub-milissegundo:

1. Detecção de Alta Entropia (Shannon Entropy):
   • Algoritmos tradicionais falham em detectar novas chaves de API ou incomuns. O Sentinel calcula a entropia de strings em janelas deslizantes. Se um bloco de texto parece "matematicamente aleatório" (como uma chave privada sk-abc123...), ele é incinerado antes de tocar no log ou no prompt.
2. Regex Nativa (Rust regex crate):
   • Compilação AOT (Ahead-Of-Time) de padrões complexos para números sensíveis (CPF, CNPJ, Cartões de Crédito). O custo de sanitizar 1MB de texto é desprezível, permitindo que tudo seja validado em tempo real sem "lag" na conversa.
3. Trade-off de Autonomia vs Inteligência Coletiva:
   • O ZERO rejeita a premissa de que a inteligência exige telemetria centralizada.
   • Modelo Mental: Usamos o "conhecimento coletivo congelado" (o LLM pré-treinado) e o especializamos com o "contexto soberano vivo" (seu RAG local). Você não precisa enviar seus dados para treinar a IA dos outros; a IA vem treinada para servir aos seus dados.

Segurança não é uma feature. É o estado padrão.

Estamos construindo a infraestrutura do amanhã. Contribuições são bem-vindas de engenheiros que buscam soberania tecnológica.

• Padrões Docstring: Seguimos o padrão estrito JSDoc para documentação técnica.
• Stack Moderna: TS (Node 22), Rust (napi-rs), Vitest, Playwright.

Este repositório é uma evolução do Clawdbot, adaptado e rearquitetado como ZERO por Leandro Azevedo para a soberania brasileira, incluindo segurança avançada e suporte a hardware local nativo.

• Erro command not found após a instalação: Reinicie seu terminal ou execute source ~/.bashrc (ou .zshrc). Se persistir, use o caminho completo: pnpm run zero.

• Acesso Externo (VPS/LAN): Por segurança, o ZERO ouve apenas no localhost. Para acessar externamente:

  1. Use um túnel SSH (Recomendado): ssh -L 18789:localhost:18789 usuario@ip_da_vps
  2. Verifique a config no ~/.zero/zero.json. O modo "bind": "lan" permite conexões externas via 0.0.0.0 (Use com cautela em ambientes públicos!).

ZERO é uma ferramenta de precisão. Use-a com intenção. Desenvolvido pelo Time de Engenharia ZERO. A soberania é inegociável.