Skip to content

Add bayes-hdc to Libraries#144

Open
rlogger wants to merge 1 commit into
n2cholas:mainfrom
rlogger:add-bayes-hdc
Open

Add bayes-hdc to Libraries#144
rlogger wants to merge 1 commit into
n2cholas:mainfrom
rlogger:add-bayes-hdc

Conversation

@rlogger

@rlogger rlogger commented May 2, 2026

Copy link
Copy Markdown

What this PR adds

Adds bayes-hdc to the Libraries section, immediately after Dynamax (positioned with the probabilistic / uncertainty-quantification cluster — NumPyro, Fortuna, BlackJAX, Dynamax — which is the closest topical fit).

What bayes-hdc is

A JAX-native library for hyperdimensional computing (HDC) and vector symbolic architectures (VSA) with a built-in probabilistic layer (PVSA):

  • 8 classical VSA models — BSC, MAP, HRR, FHRR, BSBC, CGR, MCR, VTB — under a uniform pytree-native API.
  • GaussianHV and DirichletHV distributional hypervector types with closed-form moment propagation under bind, bundle, permute, and cleanup.
  • End-to-end variational codebook training via reparameterisation gradients and a minimal lax.scan-compiled Adam loop.
  • Split-conformal prediction sets with finite-sample coverage guarantees (Romano et al. 2020).
  • Group-theoretic equivariance verifiers for the cyclic-shift action of Z/d.

To my knowledge no other open-source HDC library offers a JAX backend, end-to-end gradient training, or formal coverage guarantees — TorchHD covers PyTorch, hdlib targets bioinformatics on NumPy, NengoSPA is biologically-realistic spiking VSA. bayes-hdc fills the JAX / probabilistic / UQ lane.

Quality signals

  • Tests: 506 passing, 93 % line coverage on 23 modules.
  • CI: Ubuntu + macOS × Python 3.9–3.13 on every push.
  • Docs: Sphinx + Furo, deployed to GitHub Pages, built clean under -W (warnings as errors).
  • Lint / format / type checks: ruff check, ruff format --check, mypy bayes_hdc/ all clean.
  • License: MIT.
  • Hardware: runs on CPU / GPU / TPU; pmap and shard_map wrappers degrade gracefully on single-device hosts.
  • Provenance: every primitive cites a primary HDC/VSA paper; per-paper attribution audit at docs/audit/.

Awesome-list checklist

  • Format matches the existing line style (- [Name](url) - Description. <stars badge>).
  • Description is one sentence, factual, no marketing language.
  • Library is JAX-native (every primitive composes with jit / vmap / grad / pmap / shard_map).
  • Library is actively maintained.
  • Library is OSI-licensed (MIT).
  • Library has tests, docs, and CI.

Thanks for maintaining this list — it was useful when I was scoping the project.

bayes-hdc is a JAX-native library for hyperdimensional computing (HDC)
and vector symbolic architectures (VSA) with a probabilistic layer
(PVSA): Gaussian and Dirichlet hypervector types with closed-form
moment propagation, end-to-end variational codebook training via
reparameterisation gradients, split-conformal prediction sets with
finite-sample coverage guarantees, and group-theoretic equivariance
verifiers. Eight classical VSA models (BSC, MAP, HRR, FHRR, BSBC,
CGR, MCR, VTB) under a uniform pytree-native API.

506 unit tests, 93% line coverage, MIT license.
@rlogger

rlogger commented Jun 11, 2026

Copy link
Copy Markdown
Author

Update since filing: bayes-hdc is now on PyPI (pip install bayes-hdc), has a Zenodo DOI (10.5281/zenodo.20635099), and ships reproducible multi-seed benchmarks against TorchHD on ISOLET/UCI-HAR/EMG plus a 2-minute Colab quickstart. The library has grown to 666 tests at 93% coverage with conformal classification, regression, and anomaly detection (finite-sample FPR/FDR control) on the probabilistic-HDC stack. Happy to rebase or adjust the entry wording if useful.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant