Developer-Guide

Developer Guide: Compiling from Source

Compiling HydraDragonAntivirus is a complex task due to its many cross-language components.

Required Environments

• Python 3.12: Main engine logic.
• Rust (Nightly): Firewall and EDR drivers/engines.
• C++ (MSVC): Driver components and some analysis tools.
• Java (JDK 21): Ghidra and analysis scripts.

Build Steps (Overview)

1. Rust Components: Run cargo build --release in HydraDragonFirewall/ and Sanctum/. Build Owlyshield user-mode binaries without the service feature unless you are explicitly testing service-account behavior.
2. Drivers: Use the Developer Command Prompt for VS to build the .sys files.
3. Python: Install dependencies via poetry install or pip install -r requirements.txt.
4. Integration: Ensure all binary artifacts are placed in the expected hydradragon/ subdirectories.
5. Launcher Entry Point: Start the stack through HydraDragonAntivirusLauncher so %APPDATA%, %LOCALAPPDATA%, %USERPROFILE%, %TEMP%, and related env values resolve in the intended interactive user context.

Debugging

• Enable VERBOSE_LOGGING in the registry for driver-level info.
• Use WinDbg for kernel-mode debugging of the Sanctum driver.