Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

aspire: Accelerated Sequential Posterior Inference via REuse

DOI PyPI Documentation Status tests

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.0a13

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

Source distribution (sdist)

Source distribution for aspire-inference 0.1.0a13
File Size Uploaded
aspire_inference-0.1.0a13.tar.gz 64.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aspire-inference 0.1.0a13
File Interpreter ABI Platform
aspire_inference-0.1.0a13-py3-none-any.whl Python 3 none any Details

Total release size: 114.6 kB

Release files / aspire_inference-0.1.0a13.tar.gz

Download URL aspire_inference-0.1.0a13.tar.gz
Size 64.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8c7f63595b15c6c778a966f91e32a3d70f043e7d791a338201cf8d9b15b6478a
BLAKE2b-256 checksum
How to use checksums
8ada6e9c03088d627ede54d333c04a8c0b1b7660d11498fe8957eb721c00fb75
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 Feb 5, 2026.

Transparency log

Release files / aspire_inference-0.1.0a13-py3-none-any.whl

Download URL aspire_inference-0.1.0a13-py3-none-any.whl
Size 50.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ed4ce83d132924c8f7706574fe6af64bd78e6f66a008778a01a574c95e193f9a
BLAKE2b-256 checksum
How to use checksums
8d8edf3b5527c7b5971b9a2cbf19ef14223f415f61d2ae783b1218f3719a5503
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 Feb 5, 2026.

Transparency log
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