Binlex - Un framework de lexer de traits génétiques binaires Si les maldevs pensent que leur binaire est FUD, ils vont avoir une crise existentielle.

Binlex extrait les instructions, blocs de base et fonctions des binaires et émet des traits JSON consultables pour les flux de travail de rétro-ingénierie, de chasse et de similarité. Il modélise la structure binaire avec une hiérarchie inspirée de la génomique : génomes (instructions, blocs, fonctions), chromosomes (motifs génériques), paires d'allèles (octets) et gènes (nibbles). Cette représentation rend l'analyse de malwares et la similarité binaire plus systématiques en permettant la comparaison au niveau des motifs, le clustering et la génération de signatures sur de grands ensembles d'échantillons.

Fonctionnalités

• 🧬 Extraction rapide de traits pour les instructions, blocs et fonctions
• 🔐 Hachage et traits : MinHash, TLSH, SHA256, entropie et motifs génériques
• 📈 Normalisation et pipelines de caractéristiques pour les flux de travail de similarité orientés ML
• 🧰 Interfaces : CLI, API Rust, API/bindings Python et plugin IDA
• ⚙️ Framework de processeurs en Rust avec exécution externe rapide via ipc et http
• 🧠 Construisez vos propres processeurs Rust pour effectuer des analyses supplémentaires
• 🎯 Outils pour la génération YARA, l'ingestion de symboles et les flux de travail JSON par lots

Cibles prises en charge 🌐

• Plates-formes : Linux, macOS, Windows
• Formats : PE, ELF, Mach-O
• Architectures : AMD64, I386, CIL

Suite d'outils en ligne de commande incluse 🧰

• binlex: CLI principale pour l'extraction de traits binaires
• binlex-mcp: Serveur Model Context Protocol pour exposer les outils Binlex aux clients MCP
• binlex-server: Serveur de transport de processeurs pour les flux de travail http
• binlex-hash: Utilitaire de hachage
• binlex-image: Utilitaire lié aux images
• binlex-symbols: Assistant d'ingestion et de conversion de symboles
• binlex-yara: Génère des règles YARA à partir de motifs ou flux de style Binlex

Compilation et installation 🛠️

API Rust et outils

cargo run --manifest-path xtask/Cargo.toml
cargo build --release --workspace

Bindings Python 🐍

cd bindings/python/
virtualenv -p python3 venv/
source venv/bin/activate
pip install maturin[patchelf]
maturin develop

Packaging 📦

make zst   # Arch Linux
make deb   # Debian-based
make wheel # Python Wheel

Plugin IDA 🧠

cd plugins/ida/
pip install .
python -m binlex_ida install

Conteneurs Docker

# Local Build and Start
docker compose -f compose.yml -f compose.local.yml up --build -d
# Start Using Docker Hub
docker compose -f compose.yml -f compose.remote.yml up -d

Documentation 📚

Guides

• Guide en ligne de commande
• Processeurs personnalisés

Exemples 🧪

• Exemples Python
• Exemples Rust

API Rust

cargo doc --open

Configuration 📁

Répertoires de configuration par défaut :

• Linux : $XDG_CONFIG_HOME/binlex/binlex.toml ou $HOME/.config/binlex/
• macOS : $HOME/Library/Application Support/binlex/
• Windows : %APPDATA%\binlex\

Citation 📖

Si vous utilisez Binlex dans une publication ou un modèle d'IA open source, citez :

@misc{binlex,
  author = {c3rb3ru5d3d53c},
  title = {binlex: A Binary Genetic Trait Lexer Framework},
  year = {2025},
  note = {Available at \url{https://github.com/c3rb3ru5d3d53c/binlex}}
}

Pour tout autre usage professionnel/personnel ou sorties générées (par exemple des règles YARA), la citation n'est pas requise.