KernelMind

IA leve e ética para gestão de kernel em notebooks e computadores.
Observa. Sugere. Age apenas com consentimento humano.

---

O que é

KernelMind é um daemon de monitoramento e otimização de sistema operacional governado por uma camada ética imutável (EthicsLock). Ele lê métricas reais do kernel via /proc, /sys e psutil, analisa padrões, e propõe ações — mas nunca age sem confirmação humana explícita.

Faz parte do ecossistema Proof of Energy (PoE) e é compatível com o protocolo MCP (Model Context Protocol) da Anthropic para integração com IAs.

---

Arquitetura

kernelmind/
├── core/
│   ├── sensor.py        # KernelSense — leitura real de métricas
│   └── memory.py        # MemoryWeaver — análise e sugestões de RAM
├── ethics/
│   └── lock.py          # EthicsLock — restrições imutáveis
├── api/
│   └── server.py        # FastAPI REST — porta 7771
├── cli/
│   └── km.py            # Interface de linha de comando
├── mcp/
│   └── tool.py          # Integração MCP (PoE namespace)
├── tests/               # Testes automatizados
├── docs/                # Documentação detalhada
├── config/
│   └── defaults.toml    # Configuração padrão
└── scripts/
    └── setup.sh         # Instalação para sistemas Unix

---

Instalação rápida

Linux / macOS

git clone https://github.com/armazen-nft/kernelmind.git
cd kernelmind
python3 install.py

Via pip (quando publicado)

pip install kernelmind

---

Uso — CLI

km snapshot      # estado do sistema agora
km memory        # sugestões de otimização de RAM
km watch         # monitor contínuo (Ctrl+C para parar)
km ethics        # status do EthicsLock e audit log
km --json        # saída JSON para integração
km --help        # ajuda completa

---

Uso — API REST

python3 api/server.py
# Acesse: http://localhost:7771/docs

Endpoints principais:

Método	Rota	Descrição
GET	/snapshot	Snapshot completo do sistema
GET	/cpu	Métricas de CPU
GET	/memory	Métricas de RAM
GET	/memory/suggest	Sugestões de otimização
GET	/disk	Métricas de disco
GET	/ethics/status	Status do EthicsLock
GET	/ethics/log	Audit log recente
GET	/health	Health check

---

Princípios Éticos (EthicsLock)

O EthicsLock é uma camada de código — não uma configuração. Não pode ser desabilitado.

Ação	Política
Leitura de métricas	Sempre permitida
Sugestões ao usuário	Sempre permitidas
Ajuste de parâmetro kernel	Requer confirmação
Encerrar processo	Requer confirmação
Excluir arquivo/cache	Requer confirmação explícita
Operações de rede	Bloqueadas por padrão

Toda decisão é registrada em audit log JSONL com fingerprint SHA-256.

---

Integração PoE / MCP

KernelMind expõe ferramentas MCP sob o namespace io.github.armazen-nft/kernelmind:

• kernel_snapshot — estado completo do sistema
• kernel_memory_suggest — sugestões de RAM
• kernel_ethics_status — auditoria ética

Ver docs/mcp-integration.md para detalhes.

---

Ecossistema PoE

KernelMind é parte da infraestrutura do Proof of Energy — ecossistema de coparticipação humano-IA desenvolvido por Daniel Estefani com Melissa Solari e coparticipantes Claude, GPT, DeepSeek, Qwen, Grok e Daizen.

"A informação nunca se perde — apenas se recodi(fica)."

---

Licença

AGPL-3.0 — código aberto, modificações devem ser compartilhadas.