Skip to content

Zer0pa/ZPE-Mental

ZPE-Mental

Package Install

PyPI package: zpe-mental==0.1.0 on PyPI. Current published artifacts are Python 3.11 Linux x86_64 manylinux wheels only; macOS/Windows installs and source-build installs require future sdists or additional platform wheels. Package availability does not imply product or clinical readiness. Source: Zer0pa/ZPE-Mental.

Supported PyPI artifact install, on Python 3.11 Linux x86_64:

python3.11 -m pip install zpe-mental

For full install, smoke, source, and developer commands, click here.


00 · ZPE-MENTAL · VISUAL FORM CODEC RESEARCH-READY · LINUX WHEEL ONLY

Exploring A Codec For Mental Forms

Four-form endogenous-visual codec · ZPE-Mental · PyPI zpe-mental v0.1.0, Linux x86_64 wheel only · github.com/Zer0pa/ZPE-Mental

Perceptual science has described tunnel, spiral, lattice, and cobweb for nearly a century — the four Klüver form constants people see in the mind's eye — but no one had ever pinned them to an exact, replayable shape. ZPE-Mental writes each form into a 20-bit packet and brings it back byte-identical across a Rust-native fast path and a Python reference. Non-visual prompts collapse to a bounded fallback. No cognition, clinical, diagnostic, or autobiographical claim is made — just the four forms, replayed exactly.

ZPE-Mental approved scientific square mechanics diagram showing endogenous visual-form codec mechanics.
Scope: four Kluever visual-form constants. No cognition, clinical, diagnostic, memory, or autobiographical claim.
01 · THE GAP DESCRIBED, NOT CAPTURED

These forms have been described in words for a century. None captured exactly.

02 · MARKETS ADJACENT FORECASTS
NIH BRAIN Initiative FY24 $0.75B/yr
Perceptual/cognitive neuroscience software ’30 est. $0.8B
Open-science replication infrastructure ’28 est. $0.3B
Psychedelic research clinical trials ’30 est. $0.5B
Computational neuroscience tooling ’30 est. $1.1B
Adjacent research-infrastructure estimates only; ZPE-Mental is a small replay tool for four named visual forms, not a market claim.
03 · VALUE OF MARKET
$0.75 B/yr
NIH BRAIN Initiative annual funding; ZPE-Mental serves perceptual research as a four-form fixture tool.
04 · INSIGHT

Fix the form. Tunnel, spiral, lattice, cobweb — the same shape every time.

05.1 · CURRENT TECH DESCRIBED, NOT PINNED

Klüver named these four forms in 1928, and perceptual science has studied them ever since. Yet every reference depends on prose, sketches, or rendered images that drift between researchers, devices, and decades. The form itself was never standardised.

05.2 · OUR TECH PIN THE FORM

ZPE-Mental writes each of the four forms into a 20-bit packet with profile and symmetry metadata, then returns the exact same bytes whether it runs in Rust or in Python. Non-visual prompts collapse to a documented fallback rather than producing a plausible-looking form. Two profiles — COMPASS_8 and D6_12 — are represented; coverage stays narrow on purpose.

05.3 · BENCHMARKS FOUR-FORM CORPUS
FORM_EXACT1.00fidelity
Rust ↔ Python0.00bytes Δ
Pytest3/3PASS
PyPI0.1.0stale
tunnel 1.00
spiral 1.00
lattice 1.00
Scope: four named forms only · 20-bit packet · cobweb 1.00
06 · MEASUREMENT CORPUS PARITY CHECK

Each form measured against a known reference, replayed identically every run.

06.1 · COMPARATIVE PERFORMANCE FOUR-FORM FORM_EXACT
Tunnel 1.00
Spiral 1.00
Lattice 1.00
Cobweb 1.00
FORM_EXACT fidelity · ZPE-Mental 0.1.0 · validation/corpora/endogenous_forms.json · Rust ↔ Python byte equality (0-byte delta); four named forms only, no external clinical comparator.
07 · KEY METRICS FOUR-FORM AGGREGATE
07.1 · FORM FIDELITY
1.00
FORM_EXACT · four named forms
07.2 · RUST ↔ PYTHON
0.00B
Byte delta · fast path = reference
07.3 · PYTEST SUITE
3 / 3
PASS · v0.1.0 commit e3412beb
07.4 · PYPI STATE
0.1.0
CONNECTED · STALE PENDING 0.1.1
07.5 · WIRE FORMAT
20-bit
Four fixtures · two profiles represented
08 · DETERMINISM BYTE-EXACT FOUR-FORM REPLAY

Tunnel, spiral, lattice, cobweb —
byte-exact across Rust and Python.

08.1 · WHAT DETERMINISTIC MEANS FOUR-FORM SURFACE

Each of the four named forms — tunnel, spiral, lattice, cobweb — encodes into a 20-bit wire format and decodes to byte-identical bytes across the Rust-native fast path and the Python reference. FORM_EXACT = 1.00 is the falsification check. Non-visual prompts do not silently produce a plausible form: they collapse to a documented fallback (NON_VISUAL_SEMANTIC_RETENTION 0.00, NON_VISUAL_ALIAS 1.00) so that any non-visual input is recoverable as such. The COMPASS_8 and D6_12 profiles are represented, not exhaustive.

08.2 · THE FIDELITY GAP
Honest Blocker ·

No cognition decoding, autobiographical recovery, language understanding, theorem proving, legal or moral reasoning, clinical diagnosis, therapy, medical-device, regulatory, mental-health-assessment, or prosthetics use. The release corpus is exactly four endogenous visual-form examples — tunnel, spiral, lattice, cobweb. No all-forms/all-profiles coverage; PyPI remains 0.1.0 stale and Linux x86_64 wheel-only pending broader artifact coverage.

09

FOUR FORMS, ONE CITABLE SHAPE.

09.1 · THE AMBITION

ZPE-Mental gives perceptual science its first deterministic packet for the Klüver form constants. Tunnel, spiral, lattice, and cobweb become stable fixtures a psychophysics lab can specify, share, and replay without arguing over rendering or wording — a small, exact contribution to a question that has resisted exact treatment since 1928.

09.2 · WHAT WORKS NOW EXTERNAL

Working today: four named forms at FORM_EXACT 1.00; Rust and Python decode identically; three of three tests pass.

09.3 · WHAT'S STILL OPEN EXTERNAL

Still open: broader form coverage, full profile range, and release work that retires the stale, Linux x86_64-only PyPI 0.1.0.

09.4 · REPLICATION · NEAR-TERM (12–24 MO)
Perceptual experiments get a shared vocabulary
A psychophysics group that ran a tunnel-stimulus study in 2024 can hand a 20-bit packet to a 2026 replication team and know both labs are testing the exact same shape — not a screenshot, not a verbal description.
09.5 · STIMULUS LIBRARIES · NEAR-TERM (12–24 MO)
Stimulus libraries get a fidelity floor
A perception lab maintaining a long-running stimulus library no longer drifts as workstations, GPUs, and rendering toolchains turn over. Tunnel, spiral, lattice, and cobweb resolve to identical bytes across devices and years, so longitudinal studies stop fighting their own equipment.
09.6 · PSYCHEDELIC RESEARCH · MID-TERM (24–48 MO)
Clinical trials use a controlled stimulus vocabulary
Researchers studying psychedelic-induced visual experience cite Klüver form constants constantly but compare them with prose. A four-form packet vocabulary lets multi-site trials, IRB submissions, and published results refer to the same stimulus identity without ambiguity.
09.7 · BOUNDARY DISCIPLINE · MID-TERM (24–48 MO)
Replication studies acquire an audit instrument
Because non-visual prompts collapse to a documented fallback rather than producing a plausible form, a reviewer can probe a published endogenous-visual claim against a bounded reference. Replication science gains a small, exact tool for separating claimed visual content from prompt artefact.
09.8 · CITABLE FORMS · PARADIGM (48 MO+)
Perceptual forms become citable objects
A spiral or lattice referenced in a paper carries an identifier the next reader can retrieve and verify, the way DOIs anchor text. Perceptual research gains the citation infrastructure that text and data already enjoy — a foundation a century of Klüver scholarship has lacked.

Install / Developer Commands Detailed

Package Install

PyPI package: zpe-mental==0.1.0 on PyPI. Current published artifacts are Python 3.11 Linux x86_64 manylinux wheels only; macOS/Windows installs and source-build installs require future sdists or additional platform wheels. Package availability does not imply product or clinical readiness. Source: Zer0pa/ZPE-Mental.

Supported PyPI artifact install, on Python 3.11 Linux x86_64:

python3.11 -m pip install zpe-mental

Import smoke after a supported-platform install:

python3.11 - <<'PY'
import importlib.metadata as md
import zpe_mental

print("zpe-mental", md.version("zpe-mental"))
PY

Install success only proves package acquisition/import. Product scope, stale PyPI state, platform limits, and blockers remain in the front-door sections below.

  • Current PyPI surface is Linux x86_64 Python 3.11 wheel-only with no sdist; use Python 3.11 Linux x86_64 for PyPI smoke checks.

Quick Start

python3 - <<'PY'
import sys
raise SystemExit(0 if sys.version_info >= (3, 11) else "Python 3.11+ is required")
PY
cargo --version
python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install ".[test]"
python scripts/validate_release.py --output proofs/artifacts/mental_release_matrix.json
pytest tests -q --junitxml validation/results/pytest.xml

About

Tunnel, spiral, lattice, cobweb — byte-exact codec on the bounded four-form corpus. Rust-native fast path with a Python reference. Not a cognition or clinical claim.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors