Skip to content
Projects

c3rb3ru5d3d53c/binlex has 607 GitHub stars and 60 forks. GitHot measured 0 stars in 24 hours and +2 in 7 days. Last checked 2026-11-16 20:27 UTC. Last push 2026-07-01.

How these counts are measured

What you can do

  • 🧬 Fast trait extraction for instructions, blocks, and functions
  • πŸ” Hashing and traits: MinHash, TLSH, SHA256, entropy, and wildcard patterns
  • πŸ“ˆ Normalization and feature pipelines for ML-oriented similarity workflows
  • 🧰 Interfaces: CLI, Rust API, Python API/bindings, and IDA plugin

Measured star growth

in 24h
0
in 7 days
+2
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A Binary Genetic Traits Lexer Framework

Security

README.md

Original

build OS Linux OS Windows OS MacOS GitHub stars GitHub license GitHub all releases binlex-python binlex-server binlex-web binlex-mcp

Binlex logo

Binlex - A Binary Genetic Trait Lexer Framework

If maldevs think their binary is FUD, they're about to have an existential crisis.

Binlex extracts instructions, basic blocks, and functions from binaries and emits searchable JSON traits for reverse engineering, hunting, and similarity workflows. It models binary structure with a genomics-inspired hierarchy: genomes (instructions, blocks, functions), chromosomes (wildcarded patterns), allele pairs (bytes), and genes (nibbles). That representation makes malware analysis and binary similarity more systematic by enabling pattern-level comparison, clustering, and signature generation across large sample sets.

Features

  • 🧬 Fast trait extraction for instructions, blocks, and functions
  • πŸ” Hashing and traits: MinHash, TLSH, SHA256, entropy, and wildcard patterns
  • πŸ“ˆ Normalization and feature pipelines for ML-oriented similarity workflows
  • 🧰 Interfaces: CLI, Rust API, Python API/bindings, and IDA plugin
  • βš™οΈ Processor framework in Rust with fast external execution over ipc and http
  • 🧠 Build you own Rust processors to perform additional analysis
  • 🎯 Tooling for YARA generation, symbol ingestion, and batch JSON workflows

Supported Targets 🌐

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

Included Command-Line Tool Suite 🧰

  • binlex: main CLI for binary trait extraction
  • binlex-mcp: Model Context Protocol server for exposing Binlex tools to MCP clients
  • binlex-server: processor transport server for http workflows
  • binlex-hash: hashing utility
  • binlex-image: image-related utility
  • binlex-symbols: symbol ingestion and conversion helper
  • binlex-yara: generate YARA rules from Binlex-style patterns or streams

Build & Install πŸ› οΈ

Rust API & Tooling

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

Python Bindings 🐍

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

IDA Plugin 🧠

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

Docker Containers

# 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

Examples πŸ§ͺ

Rust API

cargo doc --open

Configuration πŸ“

Default configuration directories:

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

Citation πŸ“–

If you use Binlex in a journal publication or an open-source AI model, cite:

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

For any other corporate/personal usage or generated outputs (for example YARA rules), citation is not required.