Skip to content

Zer0pa/ZPE-XR

Repository files navigation

ZPE-XR Masthead

Deterministic hand transport for XR two-hand streams: sub-millisecond encode+decode latency, byte-identical replay, and mixed-gesture packet delivery on the current ContactPose lane.

The codec package is real. The ContactPose benchmark lane is real. Public release readiness is still blocked because the modern comparator gate remains 0/5 and runtime closure stays external.

License: SAL v7.0 Python 3.11+ Release: PyPI v0.3.0 Current gate: PRIVATE_ONLY

Quick verify: install and verify Architecture: runtime map Public audit: explicit limits Comparator gate: 0/5 fail

ZPE-XR

What This Is Key Metrics Competitive Benchmarks What We Prove What We Don't Claim
Jump Jump Jump Jump Jump
Commercial Readiness Tests and Verification Proof Anchors Repo Shape Quick Start
Jump Jump Jump Jump Jump

What This Is

ZPE-XR is a deterministic transport codec for two-hand joint streams. It targets XR platform teams that care about packet size, transport determinism, and replay behavior more than a generic compression headline.

The honest public wedge is transport behavior on the current ContactPose lane: 0.057 ms mean encode+decode latency, byte-identical replay, and 0.479 mm mean position error while moving far less data than raw streams. The package is real and published. Public release readiness is not real because the modern comparator gate is still 0/5, Photon remains narrower semantics, and runtime closure for Unity or Meta remains external.

Key Metrics

Metric Value Baseline
Compression vs raw 23.90x Ultraleap 8.47x
Mean position error 0.479 mm MPJPE float16+zlib 0.277 mm
Encode+decode latency 0.057 ms mean float16+zlib 0.084 ms
Modern comparator gate 0/5 passed float16+zlib wins 5/5

Competitive Benchmarks

The benchmark story is mixed on purpose. ZPE-XR carries a strong transport surface on the outward-safe ContactPose lane, but the closest modern local proxy still beats it on fidelity. That is why the release posture stays private-only.

Tool Compression Fidelity Boundary
ZPE-XR live ContactPose lane 23.90x 0.479 mm MPJPE Real measured repo lane
float16+zlib local proxy 4.33x 0.277 mm MPJPE Modern comparator that wins 5/5
Ultraleap VectorHand 8.47x Code-derived transport-only comparator
Photon Fusion XR Hands 38.32x Doc-derived, narrower semantics than full position transport

What We Prove

  • The zpe-xr package and repo install surfaces are real.
  • The current ContactPose rerun proves 23.90x compression vs raw, 0.057 ms mean encode+decode latency, and 0.479 mm mean position error on the selected five-sequence lane.
  • Byte-identical replay is part of the carried transport surface.
  • The cold-start audit and release-decision packet are present and live in the repo.
  • The repo can tell the truth about strong transport behavior without pretending comparator superiority or runtime closure.

What We Don't Claim

  • No public release readiness.
  • No Unity or Meta runtime closure.
  • No Photon displacement claim.
  • No exact PRD-corpus closure claim.
  • No broad hand-tracking superiority claim.

Commercial Readiness

Field Value
Verdict BLOCKED
Commit SHA c5e8bf11a1c1
Confidence 88%
Source proofs/artifacts/2026-03-21_zpe_xr_phase5_multi_sequence_161900Z/phase5_surface_adjudication.md

Tests and Verification

Code Check Verdict
V_01 ContactPose benchmark lane PASS
V_02 Package mechanics PASS
V_03 Cold-start audit PASS
V_04 Modern comparator gate FAIL
V_05 XR-C007 runtime closure INC
V_06 Public release readiness FAIL

Proof Anchors

Path Why it matters
proofs/artifacts/2026-04-14_zpe_xr_live_014204/phase5_multi_sequence_benchmark.json Current ContactPose transport metrics
proofs/artifacts/2026-03-21_zpe_xr_phase5_multi_sequence_161900Z/phase5_surface_adjudication.md Governing claim boundary and verdict
proofs/artifacts/2026-03-21_zpe_xr_phase5_multi_sequence_161900Z/phase5_release_decision.md Release decision and blocker framing
proofs/artifacts/2026-03-21_zpe_xr_phase4_cold_start/phase4_cold_start_audit.json Package cold-start audit
proofs/artifacts/2026-03-29_zpe_xr_phase6_mac_comparator_arm64/phase6_mac_comparator_benchmark.md Comparator failure surface that keeps the gate closed

Repo Shape

Area Purpose
code/ Installable package and tests
executable/ Root verification entrypoint
docs/ Architecture, legal boundaries, and public audit limits
proofs/ Live benchmark artifacts, adjudications, and comparator packets

Quick Start

Install from PyPI:

pip install zpe-xr

Verify from source:

git clone https://github.com/Zer0pa/ZPE-XR.git zpe-xr
cd zpe-xr
python -m venv .venv
source .venv/bin/activate
python -m pip install "./code[dev]"
python ./executable/verify.py
python -m pytest ./code/tests -q

Read docs/ARCHITECTURE.md first, then docs/LEGAL_BOUNDARIES.md, then the Phase 5 and Phase 6 proof anchors above. LICENSE is the legal source of truth; the repo uses SAL v7.0.