Skip to main content

Black Codecov JOSS

https://github.com/brainets/hoi/blob/main/docs/_static/hoi-logo.png

Description

HOI (Higher Order Interactions) is a Python package to go beyond pairwise interactions by quantifying the statistical dependencies between 2 or more units using information-theoretical metrics. The package is built on top of Jax allowing computations on CPU or GPU.

Installation

Dependencies

HOI requires :

  • Python (>= 3.8)

  • numpy(>=1.22)

  • scipy (>=1.9)

  • jax

  • pandas

  • scikit-learn

  • jax-tqdm

  • tqdm

User installation

To install Jax on GPU or CPU-only, please refer to Jax’s documentation : https://jax.readthedocs.io/en/latest/installation.html

If you already have a working installation of NumPy, SciPy and Jax, the easiest way to install hoi is using pip:

pip install -U hoi

You can also install the latest version of the software directly from Github :

pip install git+https://github.com/brainets/hoi.git

For developers

For developers, you can install it in develop mode with the following commands :

git clone https://github.com/brainets/hoi.git
cd hoi
pip install -e .['full']

The full installation of HOI includes additional packages to test the software and build the documentation :

  • pytest

  • pytest-cov

  • codecov

  • xarray

  • sphinx!=4.1.0

  • sphinx-gallery

  • pydata-sphinx-theme

  • sphinxcontrib-bibtex

  • numpydoc

  • matplotlib

  • flake8

  • pep8-naming

  • black

Help and Support

Documentation

Communication

For questions, please use the following link : https://github.com/brainets/hoi/discussions

Acknowledgments

HOI was mainly developed during the Google Summer of Code 2023 (https://summerofcode.withgoogle.com/archive/2023/projects/z6hGpvLS)

Metadata

Release files for hoi 0.0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hoi 0.0.7
File Size Uploaded
hoi-0.0.7.tar.gz 33.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hoi 0.0.7
File Interpreter ABI Platform
hoi-0.0.7-py3-none-any.whl Python 3 none any Details

Total release size: 95.2 kB

Release files / hoi-0.0.7.tar.gz

Download URL hoi-0.0.7.tar.gz
Size 33.5 kB
Tags Source
SHA-256 checksum
How to use checksums
54955507bb235f8ca161fbd82f74fe611db57ff28862a3cc17554f146aea00d6
BLAKE2b-256 checksum
How to use checksums
50773598dbb6a719e4e907901f71e20383a2d2661f45ea019c72a443501f2a44
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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 Jan 30, 2026.

Transparency log

Release files / hoi-0.0.7-py3-none-any.whl

Download URL hoi-0.0.7-py3-none-any.whl
Size 61.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dfe46c339ea327f104a485c9da7c866c79dda0aaa51ba5dd3d7015a2677fe1da
BLAKE2b-256 checksum
How to use checksums
885cd1598cea7d3787e67832358bbc9908d83e9ff94263d694c02b175eef120f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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 Jan 30, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.0.7 This release

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page