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.

Related MCP server: Linux Diagnostics MCP Server

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:

Princípios Éticos (EthicsLock)

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

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.