METATRON

Assistente de teste de penetração com tecnologia de IA usando LLM local no Linux (Parrot OS)

🔱 METATRON

Assistente de Teste de Penetração com IA

---

📌 O que é o Metatron?

Metatron é um assistente de teste de penetração com IA baseado em CLI que roda inteiramente na sua máquina local — sem nuvem, sem chaves de API, sem assinaturas.

Você fornece um IP ou domínio de destino. Ele executa ferramentas reais de reconhecimento (nmap, whois, whatweb, curl, dig, nikto), envia todos os resultados para um modelo de IA rodando localmente, e a IA analisa o alvo, identifica vulnerabilidades, sugere exploits e recomenda correções. Tudo é salvo em um banco de dados MariaDB com histórico completo de varreduras.

---

✨ Recursos

• 🤖 Análise de IA Local — alimentado por metatron-qwen via Ollama, roda 100% offline
• 🔍 Reconhecimento Automatizado — nmap, whois, whatweb, curl headers, dig DNS, nikto
• 🌐 Busca na Web — pesquisa DuckDuckGo + consulta de CVE (sem necessidade de chave de API)
• 🗄️ Backend MariaDB — histórico completo de varreduras com 5 tabelas relacionadas
• ✏️ Editar / Excluir — modifique qualquer resultado salvo diretamente do CLI
• 🔁 Loop Agêntico — a IA pode solicitar mais execuções de ferramentas durante a análise
• 🚫 Sem Chaves de API — tudo é gratuito e local -📤 Exportar Relatórios

O Metatron permite exportar os resultados das varreduras em formatos de relatório claros e compartilháveis selecionando '2.view history' -> selecione o slno e exporte.

📄 PDF — relatórios profissionais de vulnerabilidades 🌐 HTML — relatórios visualizáveis no navegador

🖥️ Capturas de Tela

Menu Principal

Ferramentas de reconhecimento executando no alvo

metatron-qwen analisando resultados da varredura

Vulnerabilidades salvas no banco de dados

Exporte resultados da varredura como PDF e/ou HTML

---

🧱 Pilha de Tecnologias

Componente	Tecnologia
Linguagem	Python 3
Modelo de IA	metatron-qwen (Qwen 3.5 com ajuste fino)
Modelo Base	huihui_ai/qwen3.5-abliterated:9b
Executor de LLM	Ollama
Banco de Dados	MariaDB
SO	Parrot OS (baseado em Debian)
Busca	DuckDuckGo (gratuito, sem chave)

---

⚙️ Instalação

1. Clone o repositório

git clone https://github.com/sooryathejas/METATRON.git
cd METATRON

2. Crie e ative o ambiente virtual

python3 -m venv venv
source venv/bin/activate

3. Instale as dependências do Python

pip install -r requirements.txt

4. Instale as ferramentas do sistema

sudo apt install nmap whois whatweb curl dnsutils nikto

---

🤖 Configuração do Modelo de IA

Passo 1 — Instale o Ollama

curl -fsSL https://ollama.com/install.sh | sh

Passo 2 — Baixe o modelo base

ollama pull huihui_ai/qwen3.5-abliterated:9b

⚠️ Este modelo requer pelo menos 8,4 GB de RAM. Se o seu sistema tiver menos, use a variante 4b:

ollama pull huihui_ai/qwen3.5-abliterated:4b

Em seguida, edite o Modelfile e altere a linha FROM para o modelo 4b.

Passo 3 — Construa o modelo personalizado metatron-qwen

O repositório inclui um Modelfile que ajusta o modelo base com parâmetros específicos de pentest:

ollama create metatron-qwen -f Modelfile

Isso cria seu modelo local metatron-qwen com:

• Janela de contexto de 16.384 tokens
• Temperatura: 0.7
• Top-k: 10
• Top-p: 0.9

Passo 4 — Verifique se o modelo existe

ollama list

Você deve ver metatron-qwen na lista.

---

🗄️ Configuração do Banco de Dados

Passo 1 — Certifique-se de que o MariaDB está em execução

sudo systemctl start mariadb
sudo systemctl enable mariadb

Passo 2 — Crie o banco de dados e o usuário

mysql -u root

CREATE DATABASE metatron;
CREATE USER 'metatron'@'localhost' IDENTIFIED BY '123';
GRANT ALL PRIVILEGES ON metatron.* TO 'metatron'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Passo 3 — Crie as tabelas

mysql -u metatron -p123 metatron

CREATE TABLE history (
  sl_no     INT AUTO_INCREMENT PRIMARY KEY,
  target    VARCHAR(255) NOT NULL,
                      scan_date DATETIME NOT NULL,
                      status    VARCHAR(50) DEFAULT 'active'
);

CREATE TABLE vulnerabilities (
  id          INT AUTO_INCREMENT PRIMARY KEY,
  sl_no       INT,
  vuln_name   TEXT,
  severity    VARCHAR(50),
                              port        VARCHAR(20),
                              service     VARCHAR(100),
                              description TEXT,
                              FOREIGN KEY (sl_no) REFERENCES history(sl_no)
);

CREATE TABLE fixes (
  id       INT AUTO_INCREMENT PRIMARY KEY,
  sl_no    INT,
  vuln_id  INT,
  fix_text TEXT,
  source   VARCHAR(50),
                    FOREIGN KEY (sl_no) REFERENCES history(sl_no),
                    FOREIGN KEY (vuln_id) REFERENCES vulnerabilities(id)
);

CREATE TABLE exploits_attempted (
  id           INT AUTO_INCREMENT PRIMARY KEY,
  sl_no        INT,
  exploit_name TEXT,
  tool_used    TEXT,
  payload      LONGTEXT,
  result       TEXT,
  notes        TEXT,
  FOREIGN KEY (sl_no) REFERENCES history(sl_no)
);

CREATE TABLE summary (
  id           INT AUTO_INCREMENT PRIMARY KEY,
  sl_no        INT,
  raw_scan     LONGTEXT,
  ai_analysis  LONGTEXT,
  risk_level   VARCHAR(50),
                      generated_at DATETIME,
                      FOREIGN KEY (sl_no) REFERENCES history(sl_no)
);

---

🚀 Uso

O Metatron precisa de duas abas de terminal para funcionar.

Terminal 1 — Carregue o modelo de IA

ollama run metatron-qwen

Aguarde até ver o prompt >>>. Isso significa que o modelo está carregado na memória e pronto. Você pode deixar este terminal rodando em segundo plano.

Terminal 2 — Inicie o Metatron

cd ~/METATRON
source venv/bin/activate
python metatron.py

---

Passo a passo