malware-check

pip install malware-check

pipx install malware-check

git clone https://github.com/momenbasel/malware-check.git
cd malware-check
pip install -e ".[dev]"

# Core + analisi binaria + rilevamento file AI + YARA
pip install malware-check[full]

# Oppure installa solo ciò che ti serve
pip install malware-check[binary]
pip install malware-check[detect]
pip install malware-check[yara]

# Oppure installa gli extra manualmente
pip install pefile lief magika yara-python

pip install malware-check[detect]

# Richiede Docker - https://docs.docker.com/get-docker/
# Costruisci l'immagine sandbox (configurazione una tantum)
malware-check build-sandbox

malware-check info

# Installa la skill da GitHub
npx skills install momenbasel/malware-check --skill malware-check

# Oppure manualmente: copia skill/SKILL.md nella directory delle tue skill
cp -r skill/ ~/.claude/skills/malware-check/

pip install malware-check pefile lief yara-python

# 1. Installa la CLI
pip install malware-check pefile lief yara-python

# 2. Aggiungi alle tue istruzioni Codex (codex.md o prompt di sistema)
echo 'Usa `malware-check scan <percorso> --verbose` per analizzare file per malware.' >> AGENTS.md

# 3. Oppure installa come skill Codex
cp -r skill/ .codex/skills/malware-check/

# 1. Installa
pip install malware-check

# 2. Aggiungi alle istruzioni dell'agente:
# "Quando ti viene chiesto di controllare codice/binari per malware, usa: malware-check scan <target> --verbose"
# "Per report: malware-check scan <target> --format html -o report.html"
# "Per CI/CD: malware-check scan <target> --format sarif -o report.sarif --exit-code"

malware-check scan file_sospetto.py

# Migliori risultati quando malware-check[detect] è installato
malware-check scan payload_sospetto --verbose

malware-check scan /percorso/progetto --verbose

# Costruisci sandbox prima (una tantum)
malware-check build-sandbox

# Scansiona con analisi comportamentale
malware-check scan malware.exe --dynamic

malware-check scan /Applicazioni/AppSospetta.app --dynamic --verbose

# Report JSON
malware-check scan target/ --format json -o report.json

# Dashboard HTML
malware-check scan target/ --format html -o report.html

# SARIF per CI/CD
malware-check scan target/ --format sarif -o risultati.sarif

# Esce con codice non zero in caso di risultati (per gate CI)
malware-check scan . --format sarif -o risultati.sarif --exit-code

malware-check info

name: Scansione di Sicurezza
on: [push, pull_request]

jobs:
  malware-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Configura Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Installa malware-check
        run: pip install malware-check

      - name: Esegui scansione
        run: malware-check scan . --format sarif -o risultati.sarif --exit-code

      - name: Carica SARIF
        if: always()
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: risultati.sarif

malware-check/
├── src/malware_check/
│   ├── cli.py                 # Punto di ingresso CLI Click
│   ├── scanner.py             # Orchestratore + rilevamento file opzionale basato su Magika
│   ├── models.py              # Modelli dati Finding, FileAnalysis, ScanResult
│   ├── analyzers/
│   │   ├── code.py            # Pattern matching codice sorgente (40+ regole)
│   │   ├── binary.py          # Analisi PE/Mach-O/ELF
│   │   ├── privacy.py         # PII, tracciamento, permessi
│   │   ├── yara_engine.py     # Compilazione e scansione regole YARA
│   │   └── dynamic.py         # Analisi comportamentale sandbox Docker
│   └── reporters/
│       ├── console_reporter.py  # Output terminale Rich
│       ├── json_reporter.py     # Esportazione JSON
│       ├── html_reporter.py     # Dashboard HTML (Jinja2)
│       └── sarif_reporter.py    # SARIF 2.1.0 per CI/CD
├── rules/yara/                # Regole YARA incluse
├── tests/                     # Suite di test pytest
└── pyproject.toml             # Metadati del progetto

malware-check scan target/ --yara-rules /percorso/alle/mie/regole/

rule Mia_Regola_Personalizzata {
    meta:
        description = "Rileva pattern malware personalizzato"
        severity = "critical"
        category = "backdoor"
        confidence = "0.90"
        mitre = "T1059"
        cwe = "CWE-94"
        recommendation = "Rimuovere il codice malevolo"

    strings:
        $pattern = "stringa_sospetta"

    condition:
        $pattern
}

# Clona e installa le dipendenze di sviluppo
git clone https://github.com/momenbasel/malware-check.git
cd malware-check
pip install -e ".[dev]"

# Opzionale: includi Magika, YARA e extra binari durante lo sviluppo
pip install -e ".[dev,full]"

# Esegui i test
pytest

# Lint
ruff check src/ tests/