zpe-multimodal 3.0.2

ZPE Integrated Modality Codec with text/emoji/diagram/image/music/voice/mental/touch/smell+BPE

ZPE-IMC

What This Is

ZPE-IMC is a multimodal reference codec for the Zer0pa 20-bit word format. It packages 10 modality lanes behind one stream contract, but it does not import or orchestrate the standalone ZPE-* repos and should not be read as the family's production platform core.

Public package truth is now split cleanly. pip install zpe-multimodal closes the base Python package surface and the top-level text compatibility API. pip install "zpe-multimodal[native]" closes the public native-kernel install path by resolving zpe-imc-kernel from PyPI. The accepted runtime authority for IMC remains the March 7 Phase 6 native run-of-record; the older wave1.0 / total_words=844 demo remains frozen downstream compatibility history.

All current evidence is bounded to synthetic and reference inputs. No real-world production workload validation exists.

Readiness: staged, synthetic/reference evidence only. Public package surface available. Optional native extra available. Not the first buying surface.

Not claimed: production platform readiness, specialist-encoder parity, real-world workload validation, or that sibling ZPE-* repos literally run on IMC as runtime imports.

Part of the Zer0pa family. Sibling codec repos: ZPE-Bio, ZPE-FT, ZPE-Geo, ZPE-Ink, ZPE-IoT, ZPE-Mocap, ZPE-Neuro, ZPE-Prosody, ZPE-Robotics, ZPE-XR.

Field	Value
Architecture	MULTIMODAL_DISPATCH
Encoding	UNIFIED_20BIT_WORD

Key Metrics

Metric	Value	Baseline
MODALITIES	10	one 20-bit transport word
THROUGHPUT	276,798.72 words/sec	Phase 6 native run
DETERMINISM	11/11	benchmark scenarios
RUNTIME_TESTS	169/169	run-of-record suite

Source: proofs/logs/phase6_run_of_record_manifest.json; proofs/logs/phase6_determinism_probe.json

Competitive Benchmarks

IMC is the multimodal dispatch/reference repo, not the portfolio's comparator lane for compression sales claims. Competitive benchmark authority lives in the domain repos where the commercial wedges are actually sold: IoT, XR, Robotics, Geo, FT, Bio, Ink, Mocap, Neuro, and Prosody.

What We Prove

• One public repo ships a shared 20-bit stream contract across 10 modality lanes
• The public base package imports cleanly and preserves the top-level text compatibility helpers
• The public native extra resolves to a real Rust kernel package (zpe-imc-kernel) rather than a local-only build step
• The March 7 Phase 6 runtime packet records a Rust-backed accepted path with deterministic benchmark facts and a native scan contract
• The historical wave1.0 compatibility vector remains frozen for downstream replay and custody

What We Don't Claim

• That IMC is the first buying surface for the portfolio
• That sibling ZPE-* repos import and run on IMC as a production platform core
• Production deployment readiness or real-world workload authority
• Universal compression wins across all modalities
• That the historical 844-word demo is the current native runtime authority

Commercial Readiness

Field	Value
Verdict	STAGED
Commit SHA	e316ddd7
Confidence	Phase 6 native runtime packet plus retained multimodal benchmark packet
Source	proofs/logs/phase6_run_of_record_manifest.json; proofs/logs/phase6_rust_backend_proof.json

Tests and Verification

Code	Check	Verdict
V_01	Base package import and top-level text roundtrip	PASS
V_02	Public native extra install path (zpe-multimodal[native])	PASS
V_03	Phase 6 native run-of-record (169/169)	PASS
V_04	Determinism probe (11/11)	PASS
V_05	Multimodal benchmark packet	PASS
V_06	Historical wave1.0 compatibility vector (844)	PASS

Proof Anchors

Path	State
proofs/logs/phase6_run_of_record_manifest.json	VERIFIED
proofs/logs/phase6_rust_backend_proof.json	VERIFIED
proofs/logs/phase6_determinism_probe.json	VERIFIED
proofs/artifacts/modality_benchmarks.json	VERIFIED
docs/family/IMC_COMPATIBILITY_VECTOR.json	VERIFIED

Repo Shape

Field	Value
Proof Anchors	5 verified
Modality Lanes	10
Authority Source	proofs/logs/phase6_run_of_record_manifest.json

• code/: installable zpe-multimodal package, tests, and benchmarks
• code/rust/imc_kernel/: optional native kernel package for the public native extra
• executable/: repo-local demo and runtime harnesses
• proofs/: retained modality packet plus current Phase 6 runtime facts
• docs/: architecture, legal boundaries, and downstream contract files

Quick Start

python -m pip install --upgrade pip
python -m pip install zpe-multimodal
python - <<'PY'
import zpe_multimodal as zm
ids = zm.encode("hello zpe")
print(zm.__version__)
print(zm.decode(ids))
PY

python -m pip install "zpe-multimodal[native]"
python - <<'PY'
from zpe_multimodal.core.imc import get_kernel_backend_info
print(get_kernel_backend_info())
PY

Expected native-backend facts:

• backend='rust'
• compiled_extension=True
• fallback_used=False

Ecosystem

Workstream	Route	Notes
ZPE-Bio	github.com/Zer0pa/ZPE-Bio	Biology codec workstream
ZPE-FT	github.com/Zer0pa/ZPE-FT	Finance codec workstream
ZPE-Geo	github.com/Zer0pa/ZPE-Geo	Geospatial codec workstream
ZPE-Ink	github.com/Zer0pa/ZPE-Ink	Handwriting codec workstream
ZPE-IoT	github.com/Zer0pa/ZPE-IoT	IoT telemetry codec workstream
ZPE-Mocap	github.com/Zer0pa/ZPE-Mocap	Motion capture codec workstream
ZPE-Neuro	github.com/Zer0pa/ZPE-Neuro	Neural signal codec workstream
ZPE-Prosody	github.com/Zer0pa/ZPE-Prosody	Speech prosody codec workstream
ZPE-Robotics	github.com/Zer0pa/ZPE-Robotics	Robotics codec workstream
ZPE-XR	github.com/Zer0pa/ZPE-XR	XR spatial codec workstream
Package docs	code/README.md	Installable package surface
Architecture	docs/ARCHITECTURE.md	Current repo/runtime truth
Legal boundaries	docs/LEGAL_BOUNDARIES.md	Scope and non-claims

Who This Is For

IMC matters when you need one deterministic transport contract for heterogeneous signals, or when you need a reference codec for cross-modality tooling. If you are evaluating a first commercial wedge, start with the domain repos.

Historical Wave-1 Snapshot

The frozen wave1.0 contract and total_words=844 demo anchor remain part of the downstream compatibility story in docs/family/IMC_COMPATIBILITY_VECTOR.json. They are historical contract custody, not the current accepted runtime authority path.

Open Risks (Non-Blocking)

• All current evidence is still synthetic/reference only
• The public native extra is only as broad as the published wheel matrix; no Windows claim is made here
• IMC is still not the first-sale surface; the domain repos remain the commercial entry points

Contributing, Security, Support

• Architecture: docs/ARCHITECTURE.md
• Legal boundaries: docs/LEGAL_BOUNDARIES.md
• Package surface: code/README.md
• Changelog: CHANGELOG.md
• License: LICENSE