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

python3 -m venv venv
source venv/bin/activate

pip install -r requirements.txt

sudo apt install nmap whois whatweb curl dnsutils nikto

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

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

ollama create metatron-qwen -f Modelfile

ollama list

sudo systemctl start mariadb
sudo systemctl enable mariadb

mysql -u root

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

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)
);

ollama run metatron-qwen

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

  [1] 새 스캔
  [2] 기록 보기
  [3] 종료

[?] 대상 IP 또는 도메인 입력: 192.168.1.1

[?] 대상 IP 또는 도메인 입력: example.com

  [1] nmap
  [2] whois
  [3] whatweb
  [4] curl 헤더
  [5] dig DNS
  [6] nikto
  [a] 모두 실행 (nikto 제외)
  [n] 모두 실행 + nikto (느림)

METATRON/
├── metatron.py       ← 주요 CLI 진입점
├── db.py             ← MariaDB 연결 및 모든 CRUD 연산
├── tools.py          ← 정찰 도구 실행기 (nmap, whois 등)
├── llm.py            ← Ollama 인터페이스 및 AI 도구 디스패치 루프
├── search.py         ← DuckDuckGo 웹 검색 및 CVE 조회
├── Modelfile         ← metatron-qwen용 커스텀 모델 설정
├── requirements.txt  ← Python 의존성
├── .gitignore        ← venv, pycache, db 파일 제외
├── LICENSE           ← MIT 라이선스
├── README.md         ← 이 파일
└── screenshots/      ← 문서용 터미널 스크린샷

history              ← 스캔 세션당 한 행 (sl_no가 중심)
    │
    ├── vulnerabilities   ← 발견된 취약점, sl_no로 연결
    │       │
    │       └── fixes     ← 취약점별 수정 사항, vuln_id + sl_no로 연결
    │
    ├── exploits_attempted ← 시도된 익스플로잇, sl_no로 연결
    │
    └── summary           ← 전체 AI 분석 덤프, sl_no로 연결