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.
| 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 |
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.
| Field | Value |
|---|---|
| Architecture | XR |
| Encoding | Not assigned |
| Mechanics Asset | .github/assets/readme/lane-mechanics/XR.gif |
| 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
| 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 |
| Field | Value |
|---|---|
| Verdict | BLOCKED |
| Checks | 3/6 |
| Anchors | 6 display anchors |
| Commit | c5e8bf11a1c1 |
| Authority | README.md |
No public release readiness.; No Unity or Meta runtime closure.; No Photon displacement claim.
- 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.
- 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.
| 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 |
| 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 |
| Field | Value |
|---|---|
| Proof Anchors | 6 display anchors |
| Modality Lanes | 1 |
| Architecture | XR |
| Encoding | Not assigned |
| Verification | 3/6 checks |
| Authority Source | README.md |
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 |
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.
Install from PyPI:
pip install zpe-xrVerify 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 -qRead 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.
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.