{"id":49281989,"url":"https://github.com/zer0pa/zpe-ink","last_synced_at":"2026-04-25T19:02:30.108Z","repository":{"id":349000008,"uuid":"1176885770","full_name":"Zer0pa/ZPE-Ink","owner":"Zer0pa","description":"ZPE-Ink V0.0: DETERMINISTIC DIGITAL INK CODEC: .zpink Streams | Stroke Compression | 5x+ vs Float32 | Rust | WASM | Swift | C# Cross-Runtime","archived":false,"fork":false,"pushed_at":"2026-04-24T21:33:51.000Z","size":6222,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-24T22:37:14.998Z","etag":null,"topics":["apple-pencil","artificial-intelligence","codec","compression","computational-physics","creative-coding","cross-platform","csharp","digital-ink","digital-writing","handwriting-recognition","human-computer-interaction","lossless-compression","machine-learning","python","rust","stylus","swift","touch","webassembly"],"latest_commit_sha":null,"homepage":"https://www.zer0pa.ai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zer0pa.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-09T13:32:09.000Z","updated_at":"2026-04-23T16:40:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Zer0pa/ZPE-Ink","commit_stats":null,"previous_names":["zer0pa/zpe-ink"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Zer0pa/ZPE-Ink","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Ink","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Ink/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Ink/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Ink/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zer0pa","download_url":"https://codeload.github.com/Zer0pa/ZPE-Ink/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Ink/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32273223,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"ssl_error","status_checked_at":"2026-04-25T18:29:32.149Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple-pencil","artificial-intelligence","codec","compression","computational-physics","creative-coding","cross-platform","csharp","digital-ink","digital-writing","handwriting-recognition","human-computer-interaction","lossless-compression","machine-learning","python","rust","stylus","swift","touch","webassembly"],"created_at":"2026-04-25T19:02:29.155Z","updated_at":"2026-04-25T19:02:30.099Z","avatar_url":"https://github.com/Zer0pa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZPE-Ink\n\nZPE-Ink is an always-in-beta `.zpink` digital-ink codec — one of 17 independent encoding products in the Zer0pa portfolio. Every claim in this README is anchored to a committed proof artifact or CI test in this repository.\n\nLicense: see `LICENSE`.\n\n## What This Is\n\nZPE-Ink encodes and decodes deterministic `.zpink` stroke packets in Python, with 0.0 Hausdorff error on all measured datasets and bit-exact roundtrip fidelity backed by committed benchmark artifacts. The public proof surface covers:\n\n- lossless encode/decode roundtrip for generated stroke fixtures\n- CRC and truncated-payload rejection\n- optional pressure, tilt, and azimuth channel handling\n- static binding-contract consistency across the Python, PyO3, WASM, Swift, and C# surfaces\n\nThe committed public benchmark artifacts are in `proofs/` and their compression-ratio results are surfaced below. CI does not rerun those external corpora; the benchmark rows are static committed artifacts.\n\n## Encoding Contract\n\n| Claim | Proof artifact | CI test |\n|---|---|---|\n| `.zpink` lossless roundtrip is bit-exact for generated fixtures | `proofs/logs/20260321_technical_alignment_pytest.txt` | `code/tests/test_codec_roundtrip.py::test_lossless_roundtrip_bit_exact` |\n| Corrupted or truncated payloads are rejected | `proofs/logs/20260321_technical_alignment_pytest.txt` | `code/tests/test_codec_roundtrip.py::test_crc_tamper_detection`, `code/tests/test_codec_roundtrip.py::test_reject_truncated_payload` |\n| zero-valued optional channels can be omitted without changing decoded strokes | `proofs/logs/20260321_technical_alignment_pytest.txt` | `code/tests/test_codec_roundtrip.py::test_zero_optional_channels_are_omitted_by_default` |\n| binding headers and package version are contract-consistent | `proofs/logs/20260321_technical_alignment_binding_contracts.json` | `code/tests/test_binding_contracts.py::test_repo_binding_contracts_pass` |\n| CLI demo and roundtrip entry points execute | `proofs/logs/20260321_technical_alignment_wheel_install.txt` | `code/tests/test_cli.py` |\n\n## Public Benchmark Results\n\nThese rows are committed static artifacts. The codec ran `encode → decode → verify` on each dataset using the repo-local lossless path. CI does not rerun these external corpora; results are bounded to the sample sizes shown.\n\n| Dataset | Samples | Compression ratio | Max Hausdorff (px) | Roundtrip fidelity | Proof artifact |\n|---|---:|---:|---:|---|---|\n| UJI Pen Characters | 1,364 | **1.6111×** | 0.0 | exact | `proofs/reruns/phase3_public_benchmarks/phase3_public_benchmarks.json` |\n| CROHME (ICFHR package) | 90 | **1.4360×** | 0.0 | exact | `proofs/artifacts/public_benchmarks/dataset_matrix.json` |\n| DigiLeTs | 180 | **1.0891×** | 0.0 | exact | `proofs/artifacts/public_benchmarks/dataset_matrix.json` |\n| MathWriting excerpt | 70 | **1.1870×** | 0.0 | exact | `proofs/artifacts/public_benchmarks/dataset_matrix.json` |\n| QuickDraw (cat) | 256 | **1.0181×** | 0.0 | exact | `proofs/artifacts/public_benchmarks/dataset_matrix.json` |\n| IAM On-Line | — | — | — | skipped: registration-gated | `proofs/artifacts/public_benchmarks/dataset_matrix.json` |\n| UNIPEN | — | — | — | skipped: host unavailable | `proofs/artifacts/public_benchmarks/dataset_matrix.json` |\n\nBaseline: raw little-endian float32 x/y pairs per point. Hausdorff = 0.0 on all measured datasets means decoded coordinates match the source integers exactly.\n\n**Zero-channel suppression improvement (committed):** auto-suppressing zero tilt/azimuth streams raised CROHME mean compression from 1.52× to 1.76× (max 3.34×) and MathWriting mean from 1.06× to 1.15×. This change is captured in `proofs/artifacts/mathwriting_analysis/comparison.json` and exercised by `code/tests/test_codec_roundtrip.py::test_zero_optional_channels_are_omitted_by_default`.\n\nEncode latency on the measured corpora: median 0.02–0.10 ms/stroke (single-core Python, macOS; QuickDraw low end 0.026 ms/stroke, MathWriting high end 0.099 ms/stroke). Source: `proofs/artifacts/public_benchmarks/dataset_matrix.json` (`median_ms_per_stroke` field).\n\nThese results do not constitute a hard-corpus pass, release-readiness claim, or competitive superiority claim. See `proofs/artifacts/public_benchmarks/README.md` for full methodology notes.\n\n## Commercial Readiness\n\n| Field | Value |\n|---|---|\n| Verdict | `STAGED` |\n| Posture | No release-readiness or hard-corpus authority claim is made. Public benchmark rows are lossless-path results against raw float32 baseline only; no named external codec comparison is claimed. |\n| Release validation | `proofs/release_validation/README.md` |\n\n## What We Do Not Claim\n\n- No claim of release readiness\n- No claim of blind-clone closure\n- No claim of hard-corpus pass\n- No claim of general digital-ink dominance\n- No claim that the public benchmark rows close release readiness or hard-corpus authority\n- No claim that local binding-contract checks prove full runtime parity for every downstream environment\n- No claim that committed compression ratios on the above datasets constitute superiority over general-purpose codecs on those corpora\n\n## Quick Start\n\nDevelopment install:\n\n```bash\npython -m venv .venv\nsource .venv/bin/activate\npython -m pip install --upgrade pip\npython -m pip install -e './code[dev]'\npython -m pytest code/tests -q\npython -m zpe_ink demo\npython -m zpe_ink verify-roundtrip\n```\n\nPackage build:\n\n```bash\npython -m build\n```\n\n## Repository Links\n\n| Field | Value |\n|---|---|\n| Repository | `https://github.com/Zer0pa/ZPE-Ink` |\n| Issues | `https://github.com/Zer0pa/ZPE-Ink/issues` |\n| License | SAL v7.0 — see `LICENSE` |\n| Contact | `architects@zer0pa.ai` |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzer0pa%2Fzpe-ink","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzer0pa%2Fzpe-ink","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzer0pa%2Fzpe-ink/lists"}