avix-engine 1.0.0

AVIX: The Ultra-Premium Archival Trust Format with SHA-256 Integrity Sentry.

AVIX: The Archival Trust Format

The world's first mathematically verified, parallelized lossless image format.

AVIX (avix-engine) is an ultra-premium Python library engineered specifically for industries where data loss is physically unacceptable. Built for Medical Imaging (DICOM replacement), VFX Studio Archival, and Government Cold-Storage.

Unlike WebP, AVIF, or JPEG XL—which focus on lossy web delivery—AVIX is designed for absolute paranoia and multi-terabyte storage arrays.

🚀 Key Enterprise Features

• 🛡️ SHA-256 Integrity Sentry: Every .avix file is sealed with a cryptographic 32-byte footer. If a hard drive suffers "Bit-Rot" over 20 years and flips a single pixel, the decoder throws a fatal Exception rather than silently loading corrupted medical or scientific data.
• ⚡ 100% CPU Unleashed (Multi-Threading): Slices massive images into thousands of 1024x1024 chunks and processes them across all available logical CPU cores simultaneously using concurrent.futures.
• 🧠 Machine-Code Speed via Numba JIT: Employs advanced mathematical spatial heuristics (AVX2: Left, AVX3: Up, AVX6: Paeth Gradient) compiled dynamically to LLVM 64-bit machine code upon first execution.
• 💾 mmap Kernel Streaming: Decodes massive 8K+ images by directly mapping the hard drive file descriptor to the CPU cache, bypassing user-space RAM bottlenecks entirely.

📦 Installation

Install the engine via PyPI (Requires Python 3.8+):

pip install avix-engine

For GPU acceleration (Hybrid VRAM mode), install the optional CuPy dependency:

pip install avix-engine[gpu]

🛠️ Developer API

We provide a streamlined, minimalist API for integration into existing pipelines.

Encoding (Archival Save)

import avix

# Compress a PNG/EXR to a mathematically sealed AVIX archive
success = avix.encode('patient_scan_001.png', 'patient_scan_001.avix', mode='archival')
print(f"Archival Sealed: {success}")

Decoding (Instant Memory Extraction)

import avix

# Decode directly into a Pillow Image object via mmap streaming
try:
    img = avix.decode('patient_scan_001.avix')
    img.show()
except Exception as e:
    # If the file suffered Bit-Rot, it will be caught here instantly!
    print(f"CORRUPTION DETECTED: {e}")

Instant Preview Extraction

import avix

# Extract the embedded thumbnail in < 10 milliseconds without decoding the payload
thumb = avix.extract_thumbnail('massive_8k_texture.avix')
thumb.save('preview.jpg')

🧠 Why Not WebP or AVIF?

Formats built by Google and Apple are designed to save bandwidth on 4G networks by throwing away data the human eye can't see. AVIX throws away nothing. It is built to archive raw reality. If you are a hospital storing an MRI, or a VFX studio archiving a $100M film's raw textures, AVIX ensures the math you get out is the exact math you put in.

📄 License

This core mathematical engine is Open-Sourced under the MIT License by Escrawl Products.