# sooryathejas/METATRON

AI-powered penetration testing assistant using local LLM on linux (Parrot OS)

Repository: https://github.com/sooryathejas/METATRON
Canonical: https://ross.abutalabs.com/products/metatron
Language: Python
License: MIT
License Family: permissive
Last push: 2026-04-11T07:16:57+00:00

## Health v2 (maintenance only)
Score: 48/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 76, release rhythm 35, longevity 10
- inputs: {"age_days": 153, "days_push": 144, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3616, forks 729 (observed 2026-08-28T04:08:11.776260+00:00)

## What it is
METATRON is a CLI-based AI penetration testing assistant that runs a local LLM (via Ollama) entirely offline on Linux, primarily Parrot OS. It automates recon with tools like nmap, nikto, and whatweb, feeds results to the AI for vulnerability analysis and exploit suggestions, and stores scan history in MariaDB with PDF/HTML report export.

## Use cases
- run automated recon on a target IP or domain
- analyze scan results with a local AI to identify vulnerabilities
- get exploit suggestions and remediation recommendations offline
- keep a persistent scan history in a database
- export penetration test findings as PDF or HTML reports
- look up CVEs and search the web without API keys

## When to choose
- you want an offline, no-API-key AI assistant for pentesting on Linux
- you use Parrot OS or a similar security-focused distro and want integrated recon tooling
- you need agentic AI that can request additional tool runs during analysis
- you want scan history stored locally with report export

## When to avoid
- you need a cloud-based or team-collaborative pentest platform
- you require guaranteed accuracy — LLM analysis can produce false positives and should not replace human judgment
- you are not on Linux or cannot run Ollama with sufficient local hardware
- you need compliance-certified scanning tools

## Facets
- artifact type: cli-tool
- maturity: active
- function: penetration-testing, llm-inference, agent-framework, cli, security, search-engine
- domain: security, penetration-testing, artificial-intelligence, large-language-models, developer-tools
- platform: cli, python
- tags: offline-llm, ollama, recon-automation, vulnerability-analysis, mariadb, parrot-os, report-export, local-ai, reporting, ai-agents, command-line, linux

## Member repositories
- sooryathejas/METATRON (main) score 48

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:11.776260+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:33:35.161456+00:00, confidence not recorded.
  - readme: https://github.com/sooryathejas/METATRON (fetched 2026-08-28T04:08:11.776260+00:00, sha 52ad52c6fc71)
- Data as of 2026-08-30T08:39:29.467469+00:00.