Skip to main content

CASI structural-analysis toolkit for cipher validation, compression-assisted security indicators, and reproducible Nano-CASI artifacts.

Project description

live-casi

live-casi is a Python toolkit for Causal Amplification Security Index (CASI) analysis of byte streams, lightweight-cipher outputs, post-quantum artifacts, and related structural-integrity signals.

This repository also carries the reproducibility artifact for the IEEE NANO 2026 camera-ready paper:

Compression-Based Trust Verification of Lightweight Ciphers Deployed in Nano-IoT Communication Standards

Install

pip install live-casi

Optional extras:

pip install "live-casi[network]"   # pcap/network analysis
pip install "live-casi[causal]"    # causal graph export
pip install "live-casi[pqc]"       # post-quantum experiments
pip install "live-casi[academia]"  # text/PDF structural analysis
pip install "live-casi[all]"       # all optional dependencies

Nano-CASI IEEE NANO 2026 Artifact

Version 1.0.1 includes the Nano-CASI camera-ready artifact under:

live_casi/artifacts/nano_casi_ieee_nano_2026/

The artifact contains:

  • tables/full_coverage_matrix.csv: full 41-cipher camera-ready matrix.
  • tables/representative_table.csv: compact table used for paper reporting.
  • raw_data/: full per-cipher sweeps grouped by family.
  • results/: reduced-round, sample-sensitivity, aging, and sanitized master summaries.
  • figures/: camera-ready figure source images.

Programmatic access after installation:

from live_casi import nano_casi_artifact_path

artifact = nano_casi_artifact_path()
matrix = artifact / "tables" / "full_coverage_matrix.csv"
print(matrix)

The Speck rows use the camera-ready verdict F8-DIST: a full-round cross-round statistical distinguisher under the F8 experiment, not a key recovery result and not a practical chosen-plaintext or ciphertext-only exploit.

Core Usage

import os
from live_casi import LiveCASI

engine = LiveCASI(key_size=32, window_keys=10_000)
engine.feed(os.urandom(320_000))
engine.force_update()

print(engine.current_casi)
print(engine.current_verdict)

Command line:

cat ciphertext.bin | live-casi
live-casi --file ciphertext.bin
live-casi --test

Main Modules

Module Purpose
live_casi.core CASI engine, structural strategies, CLI
live_casi.ciphers Cipher generators used by the test suite
live_casi.frontier Detection-boundary search
live_casi.nist_compare CASI vs. NIST SP 800-22 comparison helpers
live_casi.pqc Post-quantum compression-analysis helpers
live_casi.network pcap and live-network analysis
live_casi.causal causal graph export
live_casi.academia text/PDF structural analysis
live_casi.fingerprint stylometric fingerprinting

Development

python -m pip install -e ".[all]"
python -m pytest tests/test_casi.py
python -m build

Citation

If you use the Nano-CASI artifact, cite:

David Tom Foss, "Compression-Based Trust Verification of Lightweight Ciphers
Deployed in Nano-IoT Communication Standards," IEEE NANO, 2026.

License

MIT

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

live_casi-1.0.1.tar.gz (815.2 kB view details)

Uploaded Source

Built Distribution

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

live_casi-1.0.1-py3-none-any.whl (877.0 kB view details)

Uploaded Python 3

File details

Details for the file live_casi-1.0.1.tar.gz.

File metadata

  • Download URL: live_casi-1.0.1.tar.gz
  • Upload date:
  • Size: 815.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for live_casi-1.0.1.tar.gz
Algorithm Hash digest
SHA256 0526f77e8bfe6df1507dd1149656daefba89e31fc2b2b0266db0e655f86ba085
MD5 603e704dd5183480cf68a8c69eb58987
BLAKE2b-256 322579cc1341f16f1abec86597414c4d4d8244cb080bdbab72e5d363ba83d984

See more details on using hashes here.

File details

Details for the file live_casi-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: live_casi-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 877.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for live_casi-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4d341e69db52c930028fd21adbe4a7bb1d84b27bec65c8d10c1b0581cf5ef5df
MD5 14ca723d9b6b04856c813faeeab41c0f
BLAKE2b-256 95c9dd2d650d9968075e5bc5b640e6d093f277d08f31028b14d60f3effebdcf1

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