Skip to main content

A deterministic, high‑performance static‑analysis engine that extracts high‑signal IOCs from PE binaries, text, and logs — built for SOC automation and modern threat‑analysis pipelines.

Project description

IOCX — Deterministic, Zero‑Risk IOC Extraction for Modern Security Pipelines

Official IOCX Project

IOCX is a deterministic, high‑performance static analysis engine for extracting high-signal Indicators of Compromise (IOCs) from binaries, text, and logs. It’s built for DFIR teams, SOC automation, CI/CD pipelines, and large‑scale threat‑intel ingestion.

Why it matters: IOCX guarantees snapshot‑stable output, zero‑risk static analysis, and predictable performance even under adversarial input — something regex‑only extractors simply can’t provide.

IOCX is not an OSINT reputation checker or scoring tool. It is a binary‑aware IOC engine built for DFIR, SOC automation, CI/CD, and threat‑intel ingestion.


Why IOCX Exists

Most IOC extractors are:

  • regex‑only
  • non‑deterministic
  • slow under adversarial input
  • unaware of binary structure
  • unstable across versions

IOCX fixes all of that.

It provides:

  • snapshot‑stable output
  • deterministic PE metadata extraction
  • binary‑aware heuristics
  • strict performance guarantees
  • a stable JSON schema
  • safe, static‑only analysis

If you need predictable, automatable IOC extraction — IOCX is built for you.


Version highlights (v0.7.4)

  • Full Load Config Directory parsing and validation
  • Extended Optional Header metadata for downstream heuristics
  • Structural anomaly heuristics (GuardCF, unmapped cookie, SEH issues)
  • Faster, more resilient PE Analysis
  • Raw IOC extraction remains world-class
  • Zero regressions across all workloads

Performance

  • 150–300 MB/s on raw text
  • 6–15 MB/s on typical PEs
  • Predictable even under worst‑case adversarial load.

Features

  • Extracts IOCs from PE files and raw text
  • Detects domains, URLs, IPv4/IPv6, file paths, hashes, emails, Base64
  • Crypto wallet detection (BTC, ETH)
  • Deterministic, snapshot‑stable JSON output
  • Multi‑level analysis depth (basicfull)
  • Binary‑aware static analysis (entropy, sections, imports, TLS, signatures)
  • Lightweight plugin system
  • CLI + Python API

Install

pip install iocx

CLI

iocx suspicious.exe
echo "Visit http://bad.example.com" | iocx -

Python API

from iocx.engine import Engine

engine = Engine()
results = engine.extract("suspicious.exe")
print(results)

Project Identity

The name IOCX refers exclusively to this project and the repositories under iocx-dev. Third‑party tools must not present themselves as the IOCX engine.

Community integrations should use names like:

  • iocx-<plugin>
  • iocx-extension-<feature>

License

MPL‑2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iocx-0.7.4.tar.gz (56.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iocx-0.7.4-py3-none-any.whl (70.1 kB view details)

Uploaded Python 3

File details

Details for the file iocx-0.7.4.tar.gz.

File metadata

  • Download URL: iocx-0.7.4.tar.gz
  • Upload date:
  • Size: 56.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for iocx-0.7.4.tar.gz
Algorithm Hash digest
SHA256 b48856dcfe37e46c3fbeb02d848e36d528476e8015f035bb6cf44c88627eb8bc
MD5 47524e372acb044a54ae897961622f6d
BLAKE2b-256 b76e36197c98954e95e6c8d215d7be682f8d2271648df1b208e13ee21f411d2d

See more details on using hashes here.

File details

Details for the file iocx-0.7.4-py3-none-any.whl.

File metadata

  • Download URL: iocx-0.7.4-py3-none-any.whl
  • Upload date:
  • Size: 70.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for iocx-0.7.4-py3-none-any.whl
Algorithm Hash digest
SHA256 c7bdb4a55e2f7245a3cdb4a688b312dde03bced78216a29d512c2bfc97328b70
MD5 ca2b683df20de6e4affca5639edef5ce
BLAKE2b-256 a08ed1a9323dbee29a38116450e5c7d31b954259db89acae586621f4472728aa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page