Skip to content

Zer0pa/ZPE-XR

Repository files navigation

Smaller, faster, less accurate. Deterministic VR hand-stream codec on the ContactPose evaluation surface: 23.90x compression vs raw, 0.057 ms encode+decode, 26 bytes per two-hand frame, byte-identical replay.

The modern float16+zlib comparator still wins on fidelity at 0.277 mm to our 0.479 mm — comparator gate 0/5; Unity/Meta runtime closure remains external. Transport numbers are same-machine local proxies, not vendor runtimes.

License: SAL v7.1 Python 3.11+ Release: PyPI v0.3.1 Release: BLOCKED

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

Deterministic XR transport codec. Two-hand joint streams target packet size, transport determinism, and replay behavior. Install from PyPI: pip install zpe-xr

Transport behavior on the ContactPose aggregate lane (five sequences): 23.90x compression vs raw, 0.057 ms mean encode+decode latency, 0.479 mm mean position error, and 6.63x smaller frames than the Ultraleap VectorHand local proxy. The package is real and published on PyPI. Public release is BLOCKED: the modern comparator gate is 0/5 (float16+zlib wins on fidelity), Photon semantics remain narrower, and Unity/Meta runtime closure is external.

Codec Mechanics

ZPE-XR Codec Mechanics animation

Field Value
Architecture XR
Encoding Not assigned
Mechanics Asset .github/assets/readme/lane-mechanics/XR.gif

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 (better fidelity)
Encode+decode latency 0.057 ms mean float16+zlib 0.084 ms
Bytes/frame vs Ultraleap 25.9 vs 172.0 (6.63x smaller) Ultraleap VectorHand local proxy

Source: README.md

Repo Identity

Field Value
Identifier ZPE-XR
Repository https://github.com/Zer0pa/ZPE-XR
Section encoding
Visibility PUBLIC
Architecture XR
Encoding Not assigned
Commit SHA c5e8bf11a1c1
License SAL-7.0
Authority Source README.md

Readiness

Field Value
Verdict BLOCKED
Checks 3/6
Anchors 6 display anchors
Commit c5e8bf11a1c1
Authority README.md

Honest Blocker

No public release readiness.; No Unity or Meta runtime closure.; No Photon displacement claim.

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.
  • Same-machine proxy lanes exist for Ultraleap VectorHand and Photon Fusion XR Hands, with Photon still narrower than the frozen full-position stream.
  • 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.

Verification Status

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 State
proofs/artifacts/2026-04-14_zpe_xr_live_014204/phase5_multi_sequence_benchmark.json VERIFIED
proofs/artifacts/2026-03-21_zpe_xr_phase5_multi_sequence_161900Z/phase5_surface_adjudication.md VERIFIED
proofs/artifacts/2026-03-21_zpe_xr_phase5_multi_sequence_161900Z/phase5_release_decision.md VERIFIED
proofs/artifacts/2026-03-21_zpe_xr_phase4_cold_start/phase4_cold_start_audit.json VERIFIED
proofs/artifacts/2026-03-29_zpe_xr_phase6_mac_comparator_arm64/phase6_mac_comparator_benchmark.json VERIFIED
proofs/artifacts/2026-03-29_zpe_xr_phase7_ultraleap_local/phase7_ultraleap_local_benchmark.json VERIFIED

Repo Shape

Field Value
Proof Anchors 6 display anchors
Modality Lanes 1
Architecture XR
Encoding Not assigned
Verification 3/6 checks
Authority Source README.md

Extended Metrics

Rows retained from the previous expanded ## Key Metrics table. The public product page uses the first four rows only.

Metric Value Baseline Proof anchor
Latency vs Ultraleap VectorHand (ContactPose) 0.024 ms vs 0.154 ms — 6.4x lower Ultraleap VectorHand local proxy proofs/artifacts/2026-03-29_zpe_xr_phase7_ultraleap_local/phase7_ultraleap_local_benchmark.json
Bytes/frame vs Photon (ContactPose real data) 25.9 vs 38.0 bytes — ZPE smaller on real data Photon articulation proxy (narrower semantics) proofs/artifacts/2026-03-29_zpe_xr_phase8_photon_local/phase8_photon_local_benchmark.json
Fidelity vs Photon (ContactPose) 0.479 mm vs 10.683 mm MPJPE — 22x better Photon articulation proxy proofs/artifacts/2026-03-29_zpe_xr_phase8_photon_local/phase8_photon_local_benchmark.json
Packet-loss resilience (10% loss) 0.399% pose error Ultraleap 3.80% pose error (5-seq mean) proofs/artifacts/2026-03-29_zpe_xr_phase7_ultraleap_local/phase7_ultraleap_local_benchmark.json + code/tests/test_network.py
4-player modeled bandwidth @90 fps 6.84 KB/s Ultraleap 45.35 KB/s proofs/artifacts/2026-03-29_zpe_xr_phase7_ultraleap_local/phase7_ultraleap_local_benchmark.json
Modern comparator gate 0/5 passed float16+zlib wins 5/5 proofs/artifacts/2026-03-29_zpe_xr_phase6_mac_comparator_arm64/phase6_mac_comparator_benchmark.json

Competitive Benchmarks

The benchmark story is mixed on purpose. ZPE-XR carries a strong transport surface on the ContactPose lane — 6.63x smaller frames and 9.5x better fidelity than the Ultraleap VectorHand proxy — but the closest modern local baseline (float16+zlib) still wins on fidelity (0.277 mm vs 0.479 mm). That is the honest reason the release posture stays PRIVATE_ONLY. Release posture per phase5 decision: PRIVATE_ONLY — public package shipped on PyPI v0.3.1; vendor-runtime closure (Unity/Meta) is external; comparator gate is 0/5 vs float16+zlib. All comparator rows are same-machine local proxies, not vendor runtimes.

Tool Compression vs raw Bytes/frame Fidelity (MPJPE mm) Latency (combined ms) Packet-loss error (10% loss) Boundary / evidence
ZPE-XR live ContactPose (full sequences) 23.90x 25.9 0.479 0.057 0.399% 2026-04-14_zpe_xr_live_014204 — measured local
float16+zlib local proxy 4.33x 336.1 0.277 (wins) 0.084 2026-03-29_zpe_xr_phase6_mac_comparator_arm64 — modern comparator wins 5/5
Ultraleap VectorHand local proxy 8.47x 172.0 4.554 0.154 3.80% (5-seq mean) 2026-03-29_zpe_xr_phase7_ultraleap_local — proxy measured, not vendor runtime
Photon Fusion XR Hands articulation proxy (ContactPose) 38.32x synthetic / ZPE smaller on real data 38.0 (synthetic win only) 10.683 0.179 8.90% 2026-03-29_zpe_xr_phase8_photon_local — narrower semantics, no hand-root pose metered

Key ratios vs closest open-transport comparator (Ultraleap, same-machine proxy):

  • Bytes: ZPE 6.63x smaller on ContactPose real data (25.9 vs 172.0 bytes/frame)
  • Latency: ZPE 6.4x lower on ContactPose (0.024 ms vs 0.154 ms mean)
  • Fidelity: ZPE 9.5x better MPJPE (0.479 mm vs 4.554 mm)
  • Packet-loss resilience: ZPE 9.5x lower pose error at 10% loss (0.399% vs 3.80% 5-seq mean)

Note on Photon: ZPE is smaller than the Photon articulation proxy on ContactPose real-data bytes (25.9 vs 38.0 bytes/frame), but the Photon row meters only the 19-byte-per-hand finger stream and does not include shared hand-root pose — semantics are narrower than ZPE's full two-hand position stream.

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.1.

Upcoming Workstreams

This section captures the active lane priorities — what the next agent or contributor picks up, and what investors should expect. Cadence is continuous, not milestoned.

  • Float16+zlib fidelity gap closure — Research-Deferred — Investigation Underway. Current 0.479 mm MPJPE vs comparator 0.277 mm; primitive-level investigation into pose-component quantization tradeoffs. Public release blocked until this closes.
  • Unity / Meta runtime closure — Operations / External Dependency. Vendor integration shape (native plugin vs network bridge) under exploration; PRIVATE_ONLY remains correct posture meanwhile.