arraybridge

ArrayBridge provides explicit conversion and shared lifecycle utilities for NumPy, CuPy, PyTorch, TensorFlow, JAX, and pyclesperanto arrays.

Core dependencies are NumPy and metaclass-registry. Other frameworks are optional.

Quick start

import numpy as np

from arraybridge import convert_memory, detect_memory_type

value = np.arange(6).reshape(2, 3)
assert detect_memory_type(value) == "numpy"

copy = convert_memory(
    value,
    source_type="numpy",
    target_type="numpy",
    gpu_id=0,
)

convert_memory requires the declared source type, target type, and device id. The source and target MemoryType declarations perform conversion directly. The device id is required even for CPU conversions so call sites have one stable signature. A GPU target must declare that identifier as available; ArrayBridge does not silently place the value on the CPU.

Declarative decorators

from arraybridge import numpy

@numpy
def normalize(image):
    return image / max(float(image.max()), 1.0)

The framework decorators attach input_memory_type, output_memory_type, and execution_memory_type metadata, provide dtype/slice runtime parameters, and add framework-specific stream/OOM handling where supported. They do not convert inputs or outputs between frameworks and do not accept a gpu_id argument. A host runtime must call convert_memory at the boundary it plans and scope execution using the execution declaration.

Stack utilities

import numpy as np

from arraybridge import stack_slices, unstack_slices

slices = [np.zeros((8, 8)), np.ones((8, 8))]
stack = stack_slices(slices, memory_type="numpy", gpu_id=0)
restored = unstack_slices(stack, memory_type="numpy", gpu_id=0)

stack_slices requires non-empty 2D inputs. unstack_slices requires a 3D array. Both validate shape and use explicit target memory/device declarations.

Installation

pip install arraybridge
pip install "arraybridge[torch]"
pip install "arraybridge[cupy]"

Documentation: https://arraybridge.readthedocs.io

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

arraybridge-0.3.0.tar.gz (94.8 kB view details)

Uploaded Aug 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

arraybridge-0.3.0-py3-none-any.whl (32.7 kB view details)

Uploaded Aug 21, 2026 Python 3

File details

Details for the file arraybridge-0.3.0.tar.gz.

File metadata

Download URL: arraybridge-0.3.0.tar.gz
Upload date: Aug 21, 2026
Size: 94.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for arraybridge-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`7026f6f5e5c19e77e366d3d1550ecab5a1d5b20675ea412e29f65b521c525321`
MD5	`3385a33206e7bf288238b38e3680bc93`
BLAKE2b-256	`301bb7650b189bfdbfea2b2d53d59df45422436aa153fbb0b87927a97f836ad5`

See more details on using hashes here.

Provenance

The following attestation bundles were made for arraybridge-0.3.0.tar.gz:

Publisher: publish.yml on OpenHCSDev/ArrayBridge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: arraybridge-0.3.0.tar.gz
- Subject digest: 7026f6f5e5c19e77e366d3d1550ecab5a1d5b20675ea412e29f65b521c525321
- Sigstore transparency entry: 2551221324
- Sigstore integration time: Aug 21, 2026
Source repository:
- Permalink: OpenHCSDev/ArrayBridge@fcaf1139e395c4a0305e1ef4271310318c306b98
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/OpenHCSDev
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@fcaf1139e395c4a0305e1ef4271310318c306b98
- Trigger Event: push