MCPcopy Index your code
hub / github.com/DualHorizon/malbox

github.com/DualHorizon/malbox @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
2,881 symbols 7,316 edges 433 files 627 documented · 22%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

malbox banner

Rust License Discord Plugins

DocumentationInstallationAPI ReferencePlugin MarketplaceDiscord


[!IMPORTANT]
Malbox is still in a very early stage of development, currently, the platform as is, isn't ready to be utilized. There are still a lot of rough edges, the code is for the most part not refactored/optimized, and all features described further-on may not be implemented yet (or only partially).

The estimated release version to achieve something functional and stable is v0.4.0.

Overview

Malbox is an open-source malware analysis platform designed to provide security researchers, malware analysts, and cybersecurity teams with a powerful, extensible environment for analyzing files and understanding their behavior.

Why Malbox?

  • Plugin Architecture: Extend functionality easily through plugins, which can be written in Rust, Javascript and Python. Malbox's plugin system lets you extend functionality as easily as installing a package, and discover them through the Malbox marketplace.
  • High Performance: Malbox does not compromise on performance despite its modular plugin system. It primarily uses iceoryx2, a shared-memory IPC (Inter-Process-Communication) library that enables zero-copy and lock-free communication. In addition, plugin creators and users can declare and configure plugin specifics, often resulting in more optimized runtimes and adaptable use cases.
  • Completely Free and Self-Hostable: Retain full control over your infrastructure—Malbox will remain open-source and free forever.
  • User-friendly Ecosystem: Malbox’s built-in marketplace makes it easy to install official and community verified plugins. Installation does not require rebuilding or restarting the Malbox service. Plugins and profiles follow strict standards to ensure a healthy, thriving ecosystem.
  • Cloud or On-Premise Storage and Deployment: Malbox supports both cloud-based and on-premise solutions for your infrastructure and storage needs.
  • Easy Setup: Enjoy a user-friendly, minimal-overhead setup that is ready to use within minutes. Malbox emphasizes declarative configuration to reduce complexity and simplify the setup and configuration process.

Plugin Ecosystem

At the core of Malbox is its extensible plugin system, designed for analysis flexibility while maintaining process isolation. Plugins operate with a well-defined lifecycle and communication framework that enables seamless integration of new capabilities, sharing data between plugins without any duplication, and much more.

Plugins are discoverable via metadata, which defines their capabilities, requirements, and compatibility with other plugins. This allows for creating comprehensive analysis profiles that combine multiple plugins for in-depth examination of artifacts.

Plugin Marketplace

Access community verified or official plugins through our Marketplace - also available in your self-hosted Malbox instance:

Plugin Marketplace

Official Plugins

PE Analysis Network Monitor YARA Engine Memory Analysis

Featured Community Plugins

Threat Intel ML Classifier Malcat Scripting

[!IMPORTANT]
All plugins undergo security review and verification before being listed in the marketplace. Submit your plugin

Features

Analysis Capabilities

Analysis capabilities depend on the plugins installed, hence, the capabilities will continue to grow as plugins are released, both from the community and maintainers. For good measure, you can find a couple of functionalities that will be available through official plugins.

  • File Type Support
  • Windows Executables (PE32, PE32+)
  • Linux Executables (ELF)
  • Office Documents
  • PDF Files
  • Script Files (JS, VBS, PS1)
  • Archive Files

  • Analysis Features

  • Automated unpacking
  • String extraction
  • Entropy analysis
  • Network analysis
  • Memory inspection
  • Behavioral analysis
  • Custom scripting support

Analysis Result Popup

TBD Enterprise Features

  • Multi-user support with RBAC
  • Team management
  • API access and monitoring
  • Custom reporting
  • Integration capabilities

Support & Community

Contributing

We welcome contributions! See our Contributing Guide for development setup and guidelines. Also, feel free to submit issues, Malbox's development is still in an early stage and contains a lot of rough edges!

License

Licensed under GNU General Public License (GPL) - © 2024 Malbox Contributors


⬆ Back to Top • Made with ❤️ by the Malbox maintainers and its contributors

Star History Chart

Extension points exported contracts — how you extend this code

Plugin (Interface)
Base trait shared by all Malbox plugins (host and guest). The only method is [`health_check`](Plugin::health_check), wh [6 …
back-end/crates/malbox-plugin-sdk/src/plugin.rs
Submission (Interface)
(no doc)
front-end/src/lib/types/automation.ts
TransportEmitter (Interface)
Trait for emitting events to the other side of the transport. Implemented by backend-specific emitters (e.g., `IpcEmitt [4 …
back-end/crates/malbox-plugin-transport/src/traits.rs
ActivityData (Interface)
(no doc)
front-end/src/lib/types/automation.ts
Command (Interface)
(no doc) [24 implementers]
back-end/crates/malbox-cli-common/src/command.rs
Statistics (Interface)
(no doc)
front-end/src/lib/types/automation.ts
TransportReceiver (Interface)
Trait for receiving events from the other side of the transport. Implemented by backend-specific receivers (e.g., `IpcR [2 …
back-end/crates/malbox-plugin-transport/src/traits.rs
MarketplaceItem (Interface)
(no doc)
front-end/src/lib/types/marketplace.ts

Core symbols most depended-on inside this repo

clone
called by 305
back-end/crates/malbox-plugin-sdk-python/src/types/result.rs
path
called by 148
back-end/crates/malbox-utils/src/storage.rs
push
called by 130
back-end/crates/malbox-plugin-sdk/src/log.rs
collect
called by 118
back-end/examples/plugins/guest-exec-checker/src/main.rs
key
called by 94
back-end/crates/malbox-plugin-sdk-cpp/include/malbox/report.hpp
apply
called by 94
front-end/src/lib/transforms/types.ts
is_empty
called by 81
back-end/crates/malbox-scheduler/src/task/queue.rs
push
called by 78
front-end/src/lib/stores/toasts.svelte.ts

Shape

Function 1,244
Method 896
Class 501
Enum 145
Interface 95

Languages

Rust79%
TypeScript12%
C++7%
Python2%

Modules by API surface

back-end/crates/malbox-plugin-sdk-cpp/include/malbox/report.hpp75 symbols
back-end/crates/malbox-plugin-sdk-python/src/types/report.rs51 symbols
front-end/src/lib/api/types.ts49 symbols
back-end/crates/malbox-plugin-sdk/src/report/builder.rs41 symbols
back-end/crates/malbox-cli-common/src/utils/format.rs41 symbols
back-end/crates/malbox-provider-libvirt/src/domain_xml.rs33 symbols
back-end/crates/malbox-plugin-sdk-python/tests/test_types.py32 symbols
back-end/crates/malbox-plugin-sdk/src/report.rs29 symbols
back-end/crates/malbox-plugin-internal/src/manager/ipc_reactor.rs28 symbols
back-end/crates/malbox-scheduler/src/worker.rs25 symbols
back-end/crates/malbox-plugin-sdk/src/log.rs25 symbols
back-end/crates/malbox-plugin-sdk/src/context.rs25 symbols

For agents

$ claude mcp add malbox \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact