malwoverview  by alexandreborges

Malware analysis and threat hunting toolkit with extensive data source integration

Created 7 years ago
3,732 stars

Top 12.9% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Malwoverview is a comprehensive first-response threat hunting tool designed for security analysts and researchers. It consolidates data from over 20 threat intelligence sources, enabling rapid triage of malware samples, URLs, IPs, and IOCs. Its key benefit is streamlining complex investigations by providing a unified interface for diverse security data.

How It Works

This Python-based tool acts as an aggregator and client for numerous security platforms. It queries services like VirusTotal, Hybrid Analysis, URLHaus, and Shodan based on provided indicators (hashes, IPs, URLs). A core feature is its LLM enrichment capability, integrating with providers like Claude, Gemini, and OpenAI to generate AI-driven risk assessments, MITRE ATT&CK mappings, and actionable analyst recommendations. It also supports YARA scanning, IOC extraction, and PE file analysis (imphash grouping).

Quick Start & Requirements

Installation is typically done via pip: pip3.11 install git+https://github.com/alexandreborges/malwoverview or python -m pip install -U malwoverview. It requires Python 3.11+ and has been tested on Linux, macOS, and Windows. Full functionality necessitates obtaining and configuring API keys for numerous services in a .malwapi.conf file. Optional dependencies for YARA, PDF reports, and TUI are available via pip install malwoverview[yara|pdf|tui|all].

Highlighted Details

  • Extensive Integrations: Supports over 20 threat intelligence feeds and analysis platforms including VirusTotal, Hybrid Analysis, Shodan, NIST, and VulnCheck.
  • LLM Enrichment: Offers AI-powered analysis (risk assessment, MITRE mapping, recommendations) via Claude, Gemini, OpenAI, or local Ollama.
  • Interactive Modes: Features an interactive REPL and a Text User Interface (TUI) for dynamic threat hunting sessions.
  • Vulnerability Data: Integrates NIST CVE and VulnCheck databases for vulnerability lookups.

Maintenance & Community

The project is primarily maintained by Alexandre Borges, with significant contributions from Artur Marzano, Corey Forman, and Christian Clauss. No specific community channels (like Discord or Slack) are detailed in the provided README.

Licensing & Compatibility

Malwoverview is distributed under the GNU General Public License v3 or later. This copyleft license may impose restrictions on commercial use or integration into proprietary software.

Limitations & Caveats

Achieving full functionality requires the acquisition and configuration of numerous third-party API keys. The GPLv3 license necessitates careful review for any commercial deployment or integration into closed-source projects.

Health Check
Last Commit

3 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
0
Star History
101 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems").

SecGPT by Clouditera

0.5%
3k
Open-source LLM for cybersecurity tasks
Created 2 years ago
Updated 9 months ago
Feedback? Help us improve.