{"id":49282274,"url":"https://github.com/zer0pa/zpe-image","last_synced_at":"2026-05-03T23:01:23.723Z","repository":{"id":353353336,"uuid":"1216292409","full_name":"Zer0pa/ZPE-Image","owner":"Zer0pa","description":"ZPE-Image V0.0: DETERMINISTIC SPARSE-STROKE IMAGE CODEC: Geometry-Layer Encoding | 5.75x Byte Reduction | Glyph | Flow-Graph | Maze | Skeleton","archived":false,"fork":false,"pushed_at":"2026-05-03T01:39:02.000Z","size":485,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-03T03:31:03.934Z","etag":null,"topics":["artificial-intelligence","codec","compression","computational-physics","deterministic","flow-graph","geometry","glyph","image-compression","image-processing","lossless-compression","machine-learning","python","rust","skeleton-extraction","sparse-coding","stroke-encoding","vector-graphics","zer0pa","zpe"],"latest_commit_sha":null,"homepage":null,"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":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":"docs/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json","notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T19:01:25.000Z","updated_at":"2026-05-03T01:39:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Zer0pa/ZPE-Image","commit_stats":null,"previous_names":["zer0pa/zpe-image"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Zer0pa/ZPE-Image","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zer0pa","download_url":"https://codeload.github.com/Zer0pa/ZPE-Image/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FZPE-Image/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32587823,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"ssl_error","status_checked_at":"2026-05-03T22:09:10.534Z","response_time":103,"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":["artificial-intelligence","codec","compression","computational-physics","deterministic","flow-graph","geometry","glyph","image-compression","image-processing","lossless-compression","machine-learning","python","rust","skeleton-extraction","sparse-coding","stroke-encoding","vector-graphics","zer0pa","zpe"],"created_at":"2026-04-25T19:03:45.018Z","updated_at":"2026-05-03T23:01:23.718Z","avatar_url":"https://github.com/Zer0pa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZPE-Image\n\n## What This Is\n\nDeterministic sparse-stroke image encoder. Geometry-layer encoding for glyphs, flow graphs, mazes, and structural skeletons; natural-image coverage stays out of scope.\n\nTwo routes ship: a primary sparse-stroke route and a narrower hole-bearing bundle route for exactly three hole-bearing forms. Both are CI-falsified.\n\n**Strongest intrinsic result (CI-anchored, no external baseline):** 5.75× byte reduction on the five accepted sparse figures versus the internal quadtree-enhanced fallback, with 100% accept and reject rates and perturbation floors clearing documented thresholds.\n\n## Codec Mechanics\n\n\u003cp\u003e\n  \u003cimg src=\".github/assets/readme/lane-mechanics/IMAGE.gif\" alt=\"ZPE-Image Codec Mechanics animation\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n| Field | Value |\n| ------- | ------- |\n| Architecture | IMAGE_STREAM |\n| Encoding | IMAGE_SPARSE_GEOMETRY_V1 |\n| Mechanics Asset | `.github/assets/readme/lane-mechanics/IMAGE.gif` |\n\n## Key Metrics\n\n| Metric | Value | Baseline |\n| -------- | ------- | ---------- |\n| SPARSE_ACCEPTS | 5/5 | bounded pack |\n| REJECT_RATE | 100% | 7 retained negatives |\n| SPARSE_WORST_PERTURB_IOU | 0.632 | floor threshold ≥0.62 |\n| SPARSE_WORST_PERTURB_SKELETON_F1 | 0.741 | floor threshold ≥0.74 |\n\n\u003e Source: `proofs/artifacts/fresh_falsification_packet.json`, `validation/results/fresh_falsification_check.json`\n\n## Repo Identity\n\n| Field | Value |\n| ------- | ------- |\n| Identifier | ZPE-Image |\n| Repository | https://github.com/Zer0pa/ZPE-Image |\n| Section | encoding |\n| Visibility | PUBLIC |\n| Architecture | IMAGE_STREAM |\n| Encoding | IMAGE_SPARSE_GEOMETRY_V1 |\n| Commit SHA | c1ed7abaa560 |\n| License | SAL-7.0 |\n| Authority Source | proofs/artifacts/fresh_falsification_packet.json |\n\n## Readiness\n\n| Field | Value |\n| ------- | ------- |\n| Verdict | STAGED |\n| Checks | 6/6 |\n| Anchors | 3 display anchors |\n| Commit | c1ed7abaa560 |\n| Authority | proofs/artifacts/fresh_falsification_packet.json |\n\n### Honest Blocker\n\nWe do not claim photo, texture, gradient, or broad natural-image coverage.; We do not claim that the narrower hole-bearing route covers the full sparse set.; We do not claim that bounded acceptance on this pack equals general image coverage.\n\n## What We Prove\n\n- The primary sparse-stroke route accepts `glyph_a`, `fork_tree`, `loop_spine`, `maze_turns`, and `serpentine`, and rejects all 7 retained mixed and natural-image negatives on the same verification pack.\n- Under four perturbation types (dilate_1, salt_pepper_1pct, shift_x1, shift_y1) the worst-case reconstruction IoU is 0.632 and worst-case skeleton F1 is 0.741, both clearing their documented thresholds (0.62 and 0.74 respectively).\n- On accepted sparse figures the geometry-sparse-stroke encoder uses a mean of 1,362 bytes (20-bit packed) versus 7,839 bytes for the quadtree-enhanced fallback — a 5.75× byte reduction within this bounded scope.\n- The narrower hole-bearing bundle route accepts exactly `glyph_a`, `loop_spine`, and `maze_turns`; `fork_tree` and `serpentine` are correctly outside that subset. Bundle projection IoU = 1.0 and skeleton F1 = 1.0 under all perturbations for all three accepted cases.\n\n## What We Don't Claim\n\n- No photo, texture, gradient, or broad natural-image coverage.\n- The hole-bearing route does not cover the full sparse set.\n- Bounded acceptance on this pack does not equal general image coverage.\n- No external codec comparison (JPEG/WebP/AVIF/JPEG-XL) — baselines are internal only.\n\n## Verification Status\n\n| Code | Check | Verdict |\n| ------ | ------- | --------- |\n| V_01 | Primary sparse route accepts the five bounded sparse figures. | PASS |\n| V_02 | Primary sparse route rejects the mixed and natural-image buckets. | PASS |\n| V_03 | Sparse perturbation floors stay above documented thresholds (IoU ≥0.62, skeleton F1 ≥0.74). | PASS |\n| V_04 | Secondary hole-bearing route accepts exactly 3/5 positives; rejects out-of-scope positives. | PASS |\n| V_05 | Installed package imports and runs without sibling runtime dependencies. | PASS |\n| V_06 | Root repo surface ships with Zer0pa Source-Available License v7.1. | PASS |\n\n## Proof Anchors\n\n| Path | State |\n| ------ | ------- |\n| `proofs/manifests/CURRENT_VERIFICATION_PACKET.md` | VERIFIED |\n| `proofs/artifacts/fresh_falsification_packet.json` | VERIFIED |\n| `validation/results/fresh_falsification_check.json` | VERIFIED |\n\n## Repo Shape\n\n| Field | Value |\n| ------- | ------- |\n| Proof Anchors | 3 display anchors |\n| Modality Lanes | 1 |\n| Architecture | IMAGE_STREAM |\n| Encoding | IMAGE_SPARSE_GEOMETRY_V1 |\n| Verification | 6/6 checks |\n| Authority Source | proofs/artifacts/fresh_falsification_packet.json |\n\n## Extended Metrics\n\nRows retained from the previous expanded `## Key Metrics` table. The public product page uses the first four rows only.\n\n| Metric | Value | Baseline | Notes |\n|---|---:|---|---|\n| SPARSE_MEAN_BYTES | 1,362 | 7,839 quadtree baseline | 5.75× byte reduction on accepted figures |\n| BUNDLE_ACCEPTS | 3/3 | hole-bearing subset | projection IoU = 1.0 under all perturbations |\n| BUNDLE_MEAN_BYTES | 3,655 | 8,459 quadtree baseline | 2.31× byte reduction on bundle route |\n\n## Quick Start\n\n```bash\npython3 -m venv .venv\n. .venv/bin/activate\npython3 -m pip install --upgrade pip\npython3 -m pip install '.[dev]'\nzpe-image-verify --output validation/results/fresh_falsification_check.local.json\npytest -q\n```\n\n## Upcoming Workstreams\n\nThis section captures the active lane priorities — what the next agent or contributor picks up, and what investors should expect. Cadence is continuous, not milestoned.\n\n- **External comparator integration** — Active Engineering. Add gzipped-SVG and PNG-of-render-at-fixed-quality comparators to the proof artifact; report both, let reviewer pick. Removes the no-market-reference-frame gap on the current 5.75× CR claim (currently measured only against an internal quadtree fallback).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzer0pa%2Fzpe-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzer0pa%2Fzpe-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzer0pa%2Fzpe-image/lists"}