Apex Logo
APEX COMPRESS
Source Code
SYSTEM REPORT PARALLEL TOURNAMENT COMPRESSION

Modern hardware demands more from archival tools.

APEX is designed around parallel execution, content-defined deduplication, and integrated recovery rather than a single fixed compression pipeline.

Ryzen 3 Speed
115.6 MB/s
Saturates all 4 threads
Memory Bound
< 30 MB
Zero-copy mmap streaming
Parity Recovery
100% Exact
Cauchy Reed-Solomon
APEX PIPELINE TELEMETRY STREAM::LIVE
Select Execution Preset:
Active Algorithm: FastCDC + Zstd-1 Fast Track
Throughput Rate: 115.6 MB/sec (100% cores)
Compression Latency: 2.44 seconds (282 MB Corpus)
Bit-Rot Redundancy: Cauchy RS Parity (Enabled)
Memory Allocation: 28.4 MB (Bounded fixed buffer)
Container Header Layout (.apx): MAGIC 0x41505831
00000000  41 50 58 31 01 04 00 00  00 00 20 00 1a 4f b2 c9  |APX1...... ..O..|
00000010  00 00 00 02 00 00 00 14  70 61 74 68 2f 74 6f 2f  |........path/to/|
00000020  64 61 74 61 2e 62 69 6e  64 65 64 75 70 3a 31 32  |data.bindedup:12|
00000030  38 62 69 74 5f 68 61 73  68 5f 63 68 65 63 6b 30  |8bit_hash_check0|
macOS 14
Ubuntu 24
Windows 11
Files tested:142,473
SHA-256 mismatches:0
01 // THE PROBLEM STATEMENT

Architectural Comparison

Many popular archivers rely on single-threaded designs or a single fixed compression pipeline.

Vector WinRAR (.rar) 7-Zip (.7z) WinZip (.zip) ApexCompress (.apx)
Deduplication Method None (Full recompression) Sliding window solid dictionary only None FastCDC + 128-bit BLAKE2b (Sub-second)
Bit-Rot & Sector Failure Manual recovery records (rarely enabled) Solid archives have limited recovery Zero recovery capability Native Cauchy Reed-Solomon Self-Healing
Threading Concurrency Coarse thread pool; lock contention LZMA multi-threading consumes massive RAM Primarily single-stream DEFLATE Lock-Free Tournament Feeder across 100% cores
Memory Footprint Unbounded OS page-cache copies Up to 2-8 GB on high LZMA presets Unoptimized buffer allocation Strictly bounded < 30 MB via zero-copy mmap
Licensing & Lock-In Closed-source commercial nagware ($29) LGPL / Open Source Proprietary paid subscription ($34.95/yr) 100% Free GNU GPLv3 + Standalone Binary
02 // MATHEMATICAL FOUNDATIONS

The Apex Architecture

Six decoupled stages operating in zero-copy memory buffers to extract maximum mathematical density.

01 // PRECONDITIONING

11 Reversible Filters

Standard engines fail on binaries and textures because byte entropy is too chaotic. Apex analyzes incoming streams and applies reversible Delta, Planar, or BCJ machine-code filters to artificially collapse Shannon entropy before compression starts.

Entropy reduction: up to 48.2% on structured data
02 // CHUNKING & DEDUP

FastCDC Boundary Slicing

Fixed-size blocks desynchronize when a single byte is prepended. Apex uses Content-Defined Chunking (FastCDC) to detect rolling hash cut-points, computing 128-bit BLAKE2b fingerprints to eliminate identical blocks.

Measured fingerprinting overhead: < 1 µs/block on Ryzen 3
03 // TOURNAMENT ENGINE

Adaptive Core Heats

Instead of blindly applying LZMA to everything, Apex runs qualification heats across candidate engines (Zstandard, Brotli, LZMA, Deflate) on worker threads. The champion algorithm for that specific block wins the container payload.

Zero thread stalls • Sticky momentum scoring
04 // DURABILITY

Reed-Solomon Parity

Archives put in cold storage inevitably face storage bit-rot. Apex bakes Cauchy Reed-Solomon erasure coding directly into the block headers, enabling automatic mathematical recovery of damaged or corrupted sectors during extraction.

Survives physical drive sector decay
05 // CRYPTOGRAPHY

Authenticated AES-256

Zero dependency on external OpenSSL libraries. Payloads are encrypted with hardware-accelerated AES-256-CTR and authenticated with an Encrypt-then-MAC HMAC-SHA256 digest derived via 100,000 rounds of PBKDF2.

APEX has not undergone an independent cryptographic audit.
06 // ZERO-COPY KERNEL

Memory-Mapped I/O

Memory-mapped input minimizes intermediate user-space buffering. Large files are memory-mapped directly into kernel address space, keeping peak working memory tightly bounded regardless of input size.

Tested on 80GB mixed datasets without swap
03 // HARD VERIFICATION DATA

Shootout on Budget Hardware

Hardware: AMD Ryzen 3 3250U (2 cores, 4 threads, 2.6 GHz), 8 GB DDR4, NVMe PCIe 3.0 SSD. Tested on Canterbury Corpus (282 MB scaled).

DATASET: 282 MB CANTERBURY SCALED SUITE METRIC: TIME VS COMPRESSED SIZE
1. ApexCompress (Mode: Ultra) 53.20 s • 3.9 MB (Matches XZ density)
2. xz -9e (LZMA2 Ultra) 648.10 s • 3.9 MB (Over 10 mins)
DATASET: 12.3 GB XCODE TOOLCHAIN METRIC: PRODUCTION THROUGHPUT
1. ApexCompress (Mode: Fast) 52.74 s • 4.0 GB (238 MB/s)
2. xz -6 (Standard LZMA2) 648.10 s • 3.9 GB (19 MB/s)
Analysis: Apex Ultra matches XZ -9e density but finishes substantially faster. On the 12.3 GB Xcode dataset, XZ achieves slightly better density (3.9 GB vs 4.0 GB) while APEX finishes in 52.7s compared to 10.8 minutes.
MEASUREMENT: PEAK RSS

Bounded Memory

Zero-copy mmap prevents the OS from buffering massive files in RAM, keeping the process footprint flat.

8 MB Input 28.1 MB
1 GB Input 28.3 MB
10 GB Input 28.4 MB
100 GB Input 28.4 MB
Result: Processing scales to terabytes without crashing embedded constraints.
04 // ECOSYSTEM & DEVELOPER TOOLING

Engineered for Modern Workflows

From microsecond archive diffing to zero-copy selective extraction and native Python integration.

Selective Extraction

Extract specific files or glob patterns directly without decompressing skipped files to disk or allocating redundant memory buffers.

apex x archive.apx -i "*.json"
apex x vault.apx path/to/file
Zero-copy memoryview skipping • SHA-256 verified
Archive Diff Tool

Inspect changes between two archives instantly. Compares manifests, added/deleted files, modifications, and net byte deltas in milliseconds.

apex diff release_v1.apx v2.apx
apex diff a.apx b.apx --json
Header-only traversal • Machine-readable JSON
Python Library SDK

Direct Python SDK bindings for pipelines, automated systems, and in-memory byte buffer tournaments without spawning subprocesses.

import apex
apex.compress("data", "out.apx")
apex.compress_bytes(payload)
Fully typed • In-memory byte streaming
Shell & OS Integration

Native tab-completion scripts for Bash, Zsh, and Fish, plus Windows Explorer context menu registry script and macOS Finder Quick Actions.

apex completions zsh
reg import windows_context.reg
Windows context menu • macOS Finder • Shell scripts
05 // OPEN SOURCE & FREEDOM

100% Free. GNU GPLv3 Licensed.

No nagware screens. No subscription paywalls. No closed tiers. ApexCompress is free and open-source software forever.

PROJECT ETHOS

Universal Computational Freedom

GNU GENERAL PUBLIC LICENSE v3.0
Free for Commercial Use

Use ApexCompress inside your company, on your production servers, or in commercial backup pipelines without paying a single cent.

Zero Telemetry or Spying

No tracking, no analytics pinging home, and zero phone-home licensing checks. Runs completely air-gapped on isolated nodes.

Anti-Proprietary Forks

GPLv3 ensures that if anyone forks or enhances the engine, their changes must remain open-source for the entire community forever.

Read the official legal notice and copyright terms:
06 // STANDALONE DEPLOYMENT

Native Executables

Compiled natively with Nuitka into zero-dependency standalone binaries. No Python runtime required.

Recommended (macOS & Linux) Homebrew Tap

Install Apex with automatic shell completions (Bash, Zsh, Fish) and cryptographic SHA-256 validation via the official Homebrew tap.

brew install qxmcu/tap/apex
macOS (Darwin) 14 MB • v1.1.0

Verified on macOS 12+ (x86_64 and Apple Silicon via Rosetta/Native).

curl -LO https://github.com/qxmcu/apex/releases/download/v1.1.0/apex-v1.1.0-darwin-x86_64.tar.gz
tar -xzf apex-v1.1.0-darwin-x86_64.tar.gz
chmod +x apex && sudo mv apex /usr/local/bin/
Download macOS Binary
Linux (CLI) GLIBC 2.28+ • v1.1.0

Ubuntu, Debian, Fedora, Arch, Alpine. Standalone zero-dependency native ELF executable.

curl -LO https://github.com/qxmcu/apex/releases/download/v1.1.0/apex-v1.1.0-linux-x86_64.tar.gz
tar -xzf apex-v1.1.0-linux-x86_64.tar.gz
chmod +x apex && sudo mv apex /usr/local/bin/
Download Linux Binary
Windows 10 / 11 v1.1.0-STABLE

Includes Explorer right-click context menu integration script, UTF-8 console output, and O_BINARY safety.

curl -LO https://github.com/qxmcu/apex/releases/download/v1.1.0/apex-v1.1.0-windows-x86_64.zip
tar -xf apex-v1.1.0-windows-x86_64.zip
.\apex.exe --help
Download Windows Binary