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.0 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.0.tar.gz (919.1 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.0-py3-none-any.whl (980.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: live_casi-1.0.0.tar.gz
  • Upload date:
  • Size: 919.1 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.0.tar.gz
Algorithm Hash digest
SHA256 ca99dd67a39ba7ee747e4020cc4c6b1d7646385dbf4529cc601e5ea6c1cbc76b
MD5 d69f732708c8228ec96402ec9bc16962
BLAKE2b-256 3fda417d3ea1558ea4bd175970f02691dbff4cfa1220dbd171084fe9c849f087

See more details on using hashes here.

File details

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

File metadata

  • Download URL: live_casi-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 980.5 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b0b92af643dd5961549c1190931bdd0c52baf3a0344634973a0dcbc923e25b3c
MD5 8669280775d88e2e9fb9dc944c5cf71b
BLAKE2b-256 982248b5554121a17f186d19b42b27281b7ff1af1f2c0bbb4ea40c81ba5ea25a

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