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]"

# कोर + बाइनरी विश्लेषण + AI फ़ाइल डिटेक्शन + YARA
pip install malware-check[full]

# या केवल ज़रूरत के अनुसार इंस्टॉल करें
pip install malware-check[binary]
pip install malware-check[detect]
pip install malware-check[yara]

# या एक्स्ट्रा मैन्युअल रूप से इंस्टॉल करें
pip install pefile lief magika yara-python

pip install malware-check[detect]

# Docker आवश्यक - https://docs.docker.com/get-docker/
# सैंडबॉक्स इमेज बनाएं (एक बार की सेटअप)
malware-check build-sandbox

malware-check info

# GitHub से स्किल इंस्टॉल करें
npx skills install momenbasel/malware-check --skill malware-check

# या मैन्युअल: skill/SKILL.md को अपनी स्किल्स डायरेक्ट्री में कॉपी करें
cp -r skill/ ~/.claude/skills/malware-check/

pip install malware-check pefile lief yara-python

# 1. CLI इंस्टॉल करें
pip install malware-check pefile lief yara-python

# 2. अपने Codex निर्देशों (codex.md या system prompt) में जोड़ें
echo 'मैलवेयर के लिए फ़ाइलों का विश्लेषण करने के लिए `malware-check scan <path> --verbose` का उपयोग करें।' >> AGENTS.md

# 3. या Codex स्किल के रूप में इंस्टॉल करें
cp -r skill/ .codex/skills/malware-check/

# 1. इंस्टॉल करें
pip install malware-check

# 2. एजेंट निर्देशों में जोड़ें:
# "जब कोड/बाइनरी को मैलवेयर के लिए जाँचने के लिए कहा जाए, तो उपयोग करें: malware-check scan <target> --verbose"
# "रिपोर्ट के लिए: malware-check scan <target> --format html -o report.html"
# "CI/CD के लिए: malware-check scan <target> --format sarif -o report.sarif --exit-code"

malware-check scan suspicious_file.py

# बेहतर परिणाम जब malware-check[detect] इंस्टॉल हो
malware-check scan suspicious_payload --verbose

malware-check scan /path/to/project --verbose

# पहले सैंडबॉक्स बनाएं (एक बार)
malware-check build-sandbox

# व्यवहार विश्लेषण के साथ स्कैन करें
malware-check scan malware.exe --dynamic

malware-check scan /Applications/SuspiciousApp.app --dynamic --verbose

# JSON रिपोर्ट
malware-check scan target/ --format json -o report.json

# HTML डैशबोर्ड
malware-check scan target/ --format html -o report.html

# CI/CD के लिए SARIF
malware-check scan target/ --format sarif -o results.sarif

# निष्कर्षों पर गैर-शून्य कोड के साथ बाहर निकलें (CI गेट्स के लिए)
malware-check scan . --format sarif -o results.sarif --exit-code

malware-check info

name: Security Scan
on: [push, pull_request]

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

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

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

      - name: Run scan
        run: malware-check scan . --format sarif -o results.sarif --exit-code

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

malware-check/
├── src/malware_check/
│   ├── cli.py                 # Click CLI एंट्री पॉइंट
│   ├── scanner.py             # ऑर्केस्ट्रेटर + वैकल्पिक Magika-आधारित फ़ाइल डिटेक्शन
│   ├── models.py              # Finding, FileAnalysis, ScanResult डेटा मॉडल
│   ├── analyzers/
│   │   ├── code.py            # स्रोत कोड पैटर्न मिलान (40+ नियम)
│   │   ├── binary.py          # PE/Mach-O/ELF विश्लेषण
│   │   ├── privacy.py         # PII, ट्रैकिंग, अनुमतियाँ
│   │   ├── yara_engine.py     # YARA नियम संकलन और स्कैनिंग
│   │   └── dynamic.py         # Docker सैंडबॉक्स व्यवहार विश्लेषण
│   └── reporters/
│       ├── console_reporter.py  # रिच टर्मिनल आउटपुट
│       ├── json_reporter.py     # JSON निर्यात
│       ├── html_reporter.py     # HTML डैशबोर्ड (Jinja2)
│       └── sarif_reporter.py    # CI/CD के लिए SARIF 2.1.0
├── rules/yara/                # बंडल YARA नियम
├── tests/                     # pytest टेस्ट सूट
└── pyproject.toml             # प्रोजेक्ट मेटाडेटा

malware-check scan target/ --yara-rules /path/to/my/rules/

rule My_Custom_Rule {
    meta:
        description = "Detect custom malware pattern"
        severity = "critical"
        category = "backdoor"
        confidence = "0.90"
        mitre = "T1059"
        cwe = "CWE-94"
        recommendation = "Remove malicious code"

    strings:
        $pattern = "suspicious_string"

    condition:
        $pattern
}

# क्लोन करें और डेव डिपेंडेंसी इंस्टॉल करें
git clone https://github.com/momenbasel/malware-check.git
cd malware-check
pip install -e ".[dev]"

# वैकल्पिक: विकास करते समय Magika, YARA और बाइनरी एक्स्ट्रा शामिल करें
pip install -e ".[dev,full]"

# टेस्ट चलाएँ
pytest

# लिंट
ruff check src/ tests/