HypercubeHopfield
HypercubeHopfield — modern Hopfield associative memory on a Boolean
hypercube. Neurons sit on the vertices of a dim-dimensional cube
(N = 2^dim). Patterns are stored explicitly and retrieved by
softmax attention over a sparse neighborhood — not collapsed into a
Hebbian weight matrix, and not full all-to-all modern-Hopfield attention
either.
A topology you don't store. Connectivity is the mask table of the Hamming ball — one XOR per neighbor, no adjacency list, at any size. Each vertex attends only inside that ball; cost scales with connections, not with the full cube.
HypercubeAI ecosystem
HypercubeESN · HypercubeCNN · HypercubeHopfield · HypercubeWTF · HypercubeEtalon · HypercubeCascade · HypercubeLCN
📄 Foundational paper: Boolean Hypercubes as a Neural Substrate (D. C. Liptak, 2026)
HypercubeHopfield is an experiment in the HypercubeAI project — our quest to systematically re-implement classical neural architectures on a Boolean hypercube topology instead of Euclidean grids or random graphs. The central thesis is “topology-native intelligence”: the hypercube’s algebraic structure (vertex-transitive symmetry, Hamming geometry, bitwise addressing) can serve as a first-class computational substrate.
- A topology you don’t store — the graph is specified: connectivity is implicit in the vertex indices; with a seed and a few config scalars the whole reservoir reconstructs mathematically.
- Perfect homogeneity — every vertex has the same degree and the same local world, so local dynamics mean the same thing everywhere — no structural favorites baked in by a random graph.
- Cheap navigation — each neighbor is a few bit operations on the vertex index, not a pointer chase through a stored edge list, so walks stay arithmetic and cache-friendly.
- Topology-native pairing — the readout consumes the reservoir’s output with zero geometric distortion, and the learned kernels exploit the same locality that generated the dynamics. The data never leaves the hypercube it was born on.
Each product in the family is a different architecture on that same foundation.
Installation
pip install hypercube-hopfield
Pre-built wheels for Python 3.10–3.13 on Windows, Linux, and macOS. NumPy is the only runtime dependency.
Build from source (C++23 + CMake): see the Python SDK guide.
Quick Start
import numpy as np
import hypercube_hopfield as hh
# 256 neurons (dim=8, N=2^8)
net = hh.HopfieldNetwork(dim=8, seed=42)
patterns = np.random.randn(10, net.num_vertices).astype(np.float32)
net.store_patterns(patterns)
cue = patterns[0] + np.random.randn(net.num_vertices).astype(np.float32) * 0.3
result = net.recall(cue)
print(f"Converged: {result.converged}, steps: {result.steps}")
# result.state is the cleaned recall; input cue is not modified
Features
- Explicit pattern storage — modern Hopfield retrieval without a Hebbian weight matrix
- Sparse Hamming-ball attention —
reachandneighbor_fractioncontrol connectivity and cost - Two update modes — Sync (default, deterministic) and Async (guaranteed energy descent)
- Pickle /
save/load— persist config and all stored patterns - NumPy integration — automatic float32 conversion;
recalldoes not mutate the cue
Documentation
- Python SDK Reference — full API, persistence, errors
- Project README — architecture framing, C++ quick start, build
- HopfieldNetwork architecture — connectivity, energy, parameters
1 maintainer
Metadata
1 maintainer
Release files for hypercube-hopfield 1.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hypercube_hopfield-1.0.3.tar.gz | 13.2 kB | With provenance | Details for hypercube_hopfield-1.0.3.tar.gz |
Built distributions (wheels)
Total release size: 3.1 MB
Release files / hypercube_hopfield-1.0.3.tar.gz
| Download URL | hypercube_hopfield-1.0.3.tar.gz |
|---|---|
| Size | 13.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ee66e782bcd6c4d1b33f36bd10bcc99f09f1b3ecca4c80120456f6ecf8aa303
|
|
BLAKE2b-256 checksum How to use checksums |
604ed86033c0832dac4ad700bb1088981db2a3ca4d1826bed684b3903c0ed2fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp313-cp313-win_amd64.whl
| Download URL | hypercube_hopfield-1.0.3-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 160.0 kB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
aecfba0673969b9dbdaecd98658bdcd72fd3908b2d32d5794e4a222068e0a90c
|
|
BLAKE2b-256 checksum How to use checksums |
195dc8b5042c1167be08c2dedf9e0453c71e52ab2d23c4910cd41654b40d71a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | hypercube_hopfield-1.0.3-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 300.7 kB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
2567c2852aba57dde7a61356d6ce9263c4bd70c2df65507543e5db5fb8b62d66
|
|
BLAKE2b-256 checksum How to use checksums |
a8c6fc811ba1940b95dab7070d9a88a7b8d4c76fddfcb2f0bd23082c263075cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp313-cp313-macosx_11_0_x86_64.whl
| Download URL | hypercube_hopfield-1.0.3-cp313-cp313-macosx_11_0_x86_64.whl |
|---|---|
| Size | 171.1 kB |
| Tags | CPython 3.13 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
2aff083245dc95b73c1e0d5636fa740e4c1f4f75c9d330606133023c3e736ddd
|
|
BLAKE2b-256 checksum How to use checksums |
ac70566d3ae615973f24e7e207329393512d161ea37bf0d2092e433b7ede096a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | hypercube_hopfield-1.0.3-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 157.5 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
216ea50524e3c0d2a748ca5274f965ab76cc08df1301859888cad1c51d2cf911
|
|
BLAKE2b-256 checksum How to use checksums |
ebfb01bba6a15a712e9540e0473aba9f60ee760ac3b821233066a1d903b70359
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp312-cp312-win_amd64.whl
| Download URL | hypercube_hopfield-1.0.3-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 160.0 kB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
7e841d5cda7afa798825646679a3c1d66783b2463c0d1efd5151b1c7c868c52f
|
|
BLAKE2b-256 checksum How to use checksums |
394b51fda38168393a07fd2fece27b5d995ebc81eab2c834f38d67d1d7ea28ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp312-cp312-manylinux_2_28_x86_64.whl
| Download URL | hypercube_hopfield-1.0.3-cp312-cp312-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 300.8 kB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
7398d8ae130d20b900b663e5b83843481b6886c1a52f1174c1dec43bb169280a
|
|
BLAKE2b-256 checksum How to use checksums |
edd490d151ea2eebf1362ba35e601cd6f92be876b00da0b805dbaa6c640b8a76
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp312-cp312-macosx_11_0_x86_64.whl
| Download URL | hypercube_hopfield-1.0.3-cp312-cp312-macosx_11_0_x86_64.whl |
|---|---|
| Size | 171.0 kB |
| Tags | CPython 3.12 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
80c55df4a56367dc0897cdd067a67c2a7ea290569b9c96a002790387f869d498
|
|
BLAKE2b-256 checksum How to use checksums |
c80eb997a9576c130d7c91c35e9d0dcb1c9d6191c1acf58783d14ee47f93f407
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | hypercube_hopfield-1.0.3-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 157.5 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
e6680b7d74b9ebe6afaf41dbcfa5ed397a3e3696b57e822033ba000fb2bbb617
|
|
BLAKE2b-256 checksum How to use checksums |
558a9c83b51f1566fabfe9be999c386427d990f5dfb42c36180c763d86d1faec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp311-cp311-win_amd64.whl
| Download URL | hypercube_hopfield-1.0.3-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 157.1 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6aff1ae733f09b2c6fe1cd262f3b8109ea616b40802f2041e69975613806a74a
|
|
BLAKE2b-256 checksum How to use checksums |
8085a64ed4dfce226612605c0f045507b4998ceae1d63ea27a90bff1fb942fc6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp311-cp311-manylinux_2_28_x86_64.whl
| Download URL | hypercube_hopfield-1.0.3-cp311-cp311-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 299.5 kB |
| Tags | CPython 3.11 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
a5b0ec7311da3c54ecf506613b64b8c5dff545ca09b81d8c55d6ef5edc86ec9b
|
|
BLAKE2b-256 checksum How to use checksums |
0ddf8c513556e38c56fe0d232f4c82944282c43c5399842643ae4061a683fdb1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp311-cp311-macosx_11_0_x86_64.whl
| Download URL | hypercube_hopfield-1.0.3-cp311-cp311-macosx_11_0_x86_64.whl |
|---|---|
| Size | 168.7 kB |
| Tags | CPython 3.11 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
5551d0c609dcbbc5c48758b80c6b9d914a9e4ac6e605f191f67797981ce2e379
|
|
BLAKE2b-256 checksum How to use checksums |
f6f2a2f85c54504a696ea11051660a280fe22cabe65941b76de900c318db9aaa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | hypercube_hopfield-1.0.3-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 156.1 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c149796b3b85dd758426cf9829d3599c0e84f7e7d6e6c5d910d0cea4a8aecf3d
|
|
BLAKE2b-256 checksum How to use checksums |
f48f0183f0565e60d97d2569af1c3a454d9e30c229279f85af73572b4d9726fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp310-cp310-win_amd64.whl
| Download URL | hypercube_hopfield-1.0.3-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 155.6 kB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
59744a6ad796a0cdd377b2289535b0b686d275ed2be3c480075cea1f0784910b
|
|
BLAKE2b-256 checksum How to use checksums |
0353114151cf23a61e0bb425b1b75f4a0531d9d6b634a7a6081484f9a5fd7fdd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp310-cp310-manylinux_2_28_x86_64.whl
| Download URL | hypercube_hopfield-1.0.3-cp310-cp310-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 298.5 kB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
23c573b486f34eceac4d03aceb074f5cc4435c4d3fbe890bfcd967ed6ac55e40
|
|
BLAKE2b-256 checksum How to use checksums |
7d49d9e044645a253e68fff324c8d97f9f2af9284297f302f1bd141b3ce7f2a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp310-cp310-macosx_11_0_x86_64.whl
| Download URL | hypercube_hopfield-1.0.3-cp310-cp310-macosx_11_0_x86_64.whl |
|---|---|
| Size | 167.2 kB |
| Tags | CPython 3.10 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
82f1247583c6c05113a5e5d256e6d87a6e36c789af400bc62ab2882ca82b104d
|
|
BLAKE2b-256 checksum How to use checksums |
643877e5860925405ed8c3633fba1ef7802f14aa7aa251aca5103ed4ade705d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / hypercube_hopfield-1.0.3-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | hypercube_hopfield-1.0.3-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 154.8 kB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ccd7f9cbf36ebb466243864f3e70d63755b35743c343c00e72e6ef65869c102c
|
|
BLAKE2b-256 checksum How to use checksums |
ebde2ae209025306414b76e544b6b24f8dfed5be1c2b609a913dea2a515b7e32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logSecurity for hypercube-hopfield 1.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 17 files in this release have been uploaded with provenance metadata.
Attestation for hypercube_hopfield-1.0.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
