aspire: Accelerated Sequential Posterior Inference via REuse
aspire is a framework for reusing existing posterior samples to obtain new results at a reduced cost.
Installation
aspire can be installed from PyPI using pip. By default, you need to install
one of the backends for the normalizing flows, either torch or jax.
We also recommend installing minipcn if using the smc sampler:
Torch
We recommend installing torch manually to ensure correct CPU/CUDA versions are
installed. See the PyTorch installation instructions
for more details.
pip install aspire-inference[torch,minipcn]
Jax:
We recommend install jax manually to ensure the correct GPU/CUDA versions
are installed. See the jax documentation for details
pip install aspire-inference[jax,minipcn]
Important: the name of aspire on PyPI is aspire-inference but once installed
the package can be imported and used as aspire.
Quickstart
import numpy as np
from aspire import Aspire, Samples
# Define a log-likelihood and log-prior
def log_likelihood(samples):
x = samples.x
return -0.5 * np.sum(x**2, axis=-1)
def log_prior(samples):
return -0.5 * np.sum(samples.x**2, axis=-1)
# Create the initial samples
init = Samples(np.random.normal(size=(2_000, 4)))
# Define the aspire object
aspire = Aspire(
log_likelihood=log_likelihood,
log_prior=log_prior,
dims=4,
parameters=[f"x{i}" for i in range(4)],
)
# Fit the normalizing flow
aspire.fit(init, n_epochs=20)
# Sample the posterior
posterior = aspire.sample_posterior(
sampler="smc",
n_samples=500,
sampler_kwargs=dict(n_steps=100),
)
# Plot the posterior distribution
posterior.plot_corner()
Documentation
See the documentation on ReadTheDocs.
Citation
If you use aspire in your work please cite the DOI and paper.
Metadata
Release files for aspire-inference 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aspire_inference-0.1.0.tar.gz | 91.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aspire_inference-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 159.7 kB
Release files / aspire_inference-0.1.0.tar.gz
| Download URL | aspire_inference-0.1.0.tar.gz |
|---|---|
| Size | 91.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
679c0ddd8cd6f4918b55b8f1b8e38b3a8be2baa659cf46cf61578eb6e5adff83
|
|
BLAKE2b-256 checksum How to use checksums |
9fe166ac439f3f7a06fe23c9fa0eab6247cf4f48ff3d2956e5d967d2508397b1
|
| 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 Aug 3, 2026.
Transparency logRelease files / aspire_inference-0.1.0-py3-none-any.whl
| Download URL | aspire_inference-0.1.0-py3-none-any.whl |
|---|---|
| Size | 67.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c7fd738d423b5eef8000de0f8fe41ff459ff0dd926333aeb1182adbe1eb2ea11
|
|
BLAKE2b-256 checksum How to use checksums |
26befc2924aa70b08fc7ce2555c290cddea18bf9b03695a681a54453cd66f5b4
|
| 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 Aug 3, 2026.
Transparency log