Binlex - Un framework lexer de rasgos genéticos binarios Si los maldevs creen que su binario es FUD, están a punto de tener una crisis existencial.

Binlex extrae instrucciones, bloques básicos y funciones de binarios y emite rasgos JSON buscables para flujos de trabajo de ingeniería inversa, hunting y similitud. Modela la estructura binaria con una jerarquía inspirada en la genómica: genomas (instrucciones, bloques, funciones), cromosomas (patrones con comodines), pares de alelos (bytes) y genes (nibbles). Esa representación hace que el análisis de malware y la similitud binaria sean más sistemáticos al permitir la comparación a nivel de patrones, el clustering y la generación de firmas en grandes conjuntos de muestras.

Características

• 🧬 Extracción rápida de rasgos para instrucciones, bloques y funciones
• 🔐 Hashing y rasgos: MinHash, TLSH, SHA256, entropía y patrones con comodines
• 📈 Normalización y pipelines de características para flujos de trabajo de similitud orientados a ML
• 🧰 Interfaces: CLI, API de Rust, API/bindings de Python y plugin de IDA
• ⚙️ Framework de procesadores en Rust con ejecución externa rápida a través de ipc y http
• 🧠 Construye tus propios procesadores Rust para realizar análisis adicionales
• 🎯 Herramientas para generación de YARA, ingesta de símbolos y flujos de trabajo JSON por lotes

Objetivos compatibles 🌐

• Plataformas: Linux, macOS, Windows
• Formatos: PE, ELF, Mach-O
• Arquitecturas: AMD64, I386, CIL

Suite de herramientas de línea de comandos incluida 🧰

• binlex: CLI principal para extracción de rasgos binarios
• binlex-mcp: servidor del Model Context Protocol para exponer las herramientas de Binlex a clientes MCP
• binlex-server: servidor de transporte de procesadores para flujos de trabajo http
• binlex-hash: utilidad de hashing
• binlex-image: utilidad relacionada con imágenes
• binlex-symbols: asistente de ingesta y conversión de símbolos
• binlex-yara: genera reglas YARA a partir de patrones de estilo Binlex o flujos

Compilación e instalación 🛠️

API de Rust y herramientas

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

Bindings de Python 🐍

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

Empaquetado 📦

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

Plugin de IDA 🧠

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

Contenedores 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

Documentación 📚

Guías

• Guía de línea de comandos
• Procesadores personalizados

Ejemplos 🧪

• Ejemplos de Python
• Ejemplos de Rust

API de Rust

cargo doc --open

Configuración 📁

Directorios de configuración predeterminados:

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

Citación 📖

Si utilizas Binlex en una publicación académica o en un modelo de IA de código abierto, cita:

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

Para cualquier otro uso corporativo o personal, o para resultados generados (por ejemplo, reglas YARA), no se requiere citación.