Skip to main content

Tensogram Python Bindings

Python bindings for the Tensogram N-tensor message format.

Native extension built with PyO3 + maturin. Supports NumPy arrays, async I/O, and GIL-free operation on free-threaded Python (3.13t / 3.14t).

Installation

pip install tensogram
# or, with the xarray and Zarr backends:
pip install tensogram[all]

Usage

import numpy as np
import tensogram

data = np.random.randn(100, 200).astype(np.float32)
msg = tensogram.encode(
    {"version": 3},
    [(
        {"type": "ntensor", "shape": [100, 200], "dtype": "float32",
         "compression": "szip"},
        data,
    )],
)
result = tensogram.decode(msg)
arr = result.objects[0][1]   # numpy array

Features

  • NumPy integration across every supported dtype (float / complex / int / uint, plus bitmask and bfloat16)
  • Sync and async file APIs (TensogramFile / AsyncTensogramFile)
  • GIL-free parallel encode / decode on free-threaded Python
  • Partial-range decode (decode_range)
  • Full codec support: szip, zstd, lz4, blosc2, zfp, sz3
  • Validation (tensogram.validate, tensogram.validate_file)
  • GRIB / NetCDF conversion (when the wheel is built with the matching feature)

Documentation

License

Copyright 2026- ECMWF. Licensed under Apache-2.0. See LICENSE.

Metadata

Release files for tensogram 0.24.0

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

Built distributions (wheels)

Table of built distributions (wheels) for tensogram 0.24.0
File
tensogram-0.24.0-cp314-cp314t-manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 Details
tensogram-0.24.0-cp314-cp314t-manylinux_2_28_aarch64.whl CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64 Details
tensogram-0.24.0-cp314-cp314t-macosx_13_0_arm64.whl CPython 3.14 CPython 3.14 free-threading macOS 13.0+ ARM64 Details
tensogram-0.24.0-cp314-cp314-manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.28+ x86-64 Details
tensogram-0.24.0-cp314-cp314-manylinux_2_28_aarch64.whl CPython 3.14 CPython 3.14 Linux glibc 2.28+ ARM64 Details
tensogram-0.24.0-cp314-cp314-macosx_13_0_arm64.whl CPython 3.14 CPython 3.14 macOS 13.0+ ARM64 Details
tensogram-0.24.0-cp313-cp313t-manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 free-threading Linux glibc 2.28+ x86-64 Details
tensogram-0.24.0-cp313-cp313t-manylinux_2_28_aarch64.whl CPython 3.13 CPython 3.13 free-threading Linux glibc 2.28+ ARM64 Details
tensogram-0.24.0-cp313-cp313t-macosx_13_0_arm64.whl CPython 3.13 CPython 3.13 free-threading macOS 13.0+ ARM64 Details
tensogram-0.24.0-cp313-cp313-manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ x86-64 Details
tensogram-0.24.0-cp313-cp313-manylinux_2_28_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ ARM64 Details
tensogram-0.24.0-cp313-cp313-macosx_13_0_arm64.whl CPython 3.13 CPython 3.13 macOS 13.0+ ARM64 Details
tensogram-0.24.0-cp312-cp312-manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64 Details
tensogram-0.24.0-cp312-cp312-manylinux_2_28_aarch64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ ARM64 Details
tensogram-0.24.0-cp312-cp312-macosx_13_0_arm64.whl CPython 3.12 CPython 3.12 macOS 13.0+ ARM64 Details
tensogram-0.24.0-cp311-cp311-manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64 Details
tensogram-0.24.0-cp311-cp311-manylinux_2_28_aarch64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ ARM64 Details
tensogram-0.24.0-cp311-cp311-macosx_13_0_arm64.whl CPython 3.11 CPython 3.11 macOS 13.0+ ARM64 Details

Total release size: 105.3 MB

Release files / tensogram-0.24.0-cp314-cp314t-manylinux_2_28_x86_64.whl

Download URL tensogram-0.24.0-cp314-cp314t-manylinux_2_28_x86_64.whl
Size 6.1 MB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
d45edd29ae8cce60dd29f1d357b423f7f53ca7f4a53640e998a3f063ee2edbad
BLAKE2b-256 checksum
How to use checksums
f4f34838aa339a76675214e18da8b25ce038b18ffe75b4fd3c150524a3d84c29
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp314-cp314t-manylinux_2_28_aarch64.whl

Download URL tensogram-0.24.0-cp314-cp314t-manylinux_2_28_aarch64.whl
Size 6.1 MB
Tags CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
82047ea25776456dc2567d71ac4d6e41aad2e753c829b966f3594830d5fa9e17
BLAKE2b-256 checksum
How to use checksums
0737deb58c33b58c0017f1f9b0fe6ee47a601a1b28afa9017a8c0416ccfa4847
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp314-cp314t-macosx_13_0_arm64.whl

Download URL tensogram-0.24.0-cp314-cp314t-macosx_13_0_arm64.whl
Size 5.4 MB
Tags CPython 3.14 CPython 3.14 free-threading macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
e5c6b873c3698332baeb0ff6e662a4ccdbc68304f10135ad8ee4af03c3d82032
BLAKE2b-256 checksum
How to use checksums
9678145d6938106b459c49a4e0fbc0a6fa434c6c977c516f3c5ac5e03a6ebe84
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp314-cp314-manylinux_2_28_x86_64.whl

Download URL tensogram-0.24.0-cp314-cp314-manylinux_2_28_x86_64.whl
Size 6.1 MB
Tags CPython 3.14 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
fd6b46be0a7bd35c89d19815d64a5f7262fd205e3fa99466d8b965d3247772b2
BLAKE2b-256 checksum
How to use checksums
5e3f807f7c0a93bef4d4430ba30aee37dcf7b0ab3cef33311cf3ad5ca2309f9a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp314-cp314-manylinux_2_28_aarch64.whl

Download URL tensogram-0.24.0-cp314-cp314-manylinux_2_28_aarch64.whl
Size 6.1 MB
Tags CPython 3.14 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
bb256750e1c948cc8f7f60f794df8123190833fd1be1ee36aae390bcac8d0157
BLAKE2b-256 checksum
How to use checksums
a3ec9d6ac329fd5355afcf28f6c823488858c1e55a94dd47819c8b3bc894208f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp314-cp314-macosx_13_0_arm64.whl

Download URL tensogram-0.24.0-cp314-cp314-macosx_13_0_arm64.whl
Size 5.4 MB
Tags CPython 3.14 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
24fa8fa7c65c907ba0a2ca8271e83185783b7b2079766677be06ffaf6170cd23
BLAKE2b-256 checksum
How to use checksums
5d57d849f97d09758418ec713afe6aa72fcc08debf6a887ac9cb0d5ff4e0d537
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp313-cp313t-manylinux_2_28_x86_64.whl

Download URL tensogram-0.24.0-cp313-cp313t-manylinux_2_28_x86_64.whl
Size 6.1 MB
Tags CPython 3.13 CPython 3.13 free-threading Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
208e15819c2274d7a559b26c0a7f18751a9716a67a0c4024aea1f0ce52c5eeda
BLAKE2b-256 checksum
How to use checksums
0c87b4d9b90326cf58a21bd2539809788683bfc697bce6b43774cdaf437683b1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp313-cp313t-manylinux_2_28_aarch64.whl

Download URL tensogram-0.24.0-cp313-cp313t-manylinux_2_28_aarch64.whl
Size 6.1 MB
Tags CPython 3.13 CPython 3.13 free-threading Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
be82d37b699ef683c18a7ea0eb14b66ffee3541bd86d4d6c94a35161c9354dbd
BLAKE2b-256 checksum
How to use checksums
b3cabece17a69de3ce9bc0f7fc79f7efb650096c0934426763369dc5223994d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp313-cp313t-macosx_13_0_arm64.whl

Download URL tensogram-0.24.0-cp313-cp313t-macosx_13_0_arm64.whl
Size 5.4 MB
Tags CPython 3.13 CPython 3.13 free-threading macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
641266b7a37d3aec07083cd628ecbe33fb4cb0b8fd7de5790b0eeb580ce06342
BLAKE2b-256 checksum
How to use checksums
fc383dae1da2b15fc3903980f7350ad30f63b2c0633a6107388151cbfd41d5ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp313-cp313-manylinux_2_28_x86_64.whl

Download URL tensogram-0.24.0-cp313-cp313-manylinux_2_28_x86_64.whl
Size 6.1 MB
Tags CPython 3.13 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
16e1693f578adec2aac741ba69f5223ccd6e52cd47fa81478c5a83b7549318ab
BLAKE2b-256 checksum
How to use checksums
ef5e28fad0d08cf9468980d3ff94cd4d22bfa267f8204f19510faf939a969b9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp313-cp313-manylinux_2_28_aarch64.whl

Download URL tensogram-0.24.0-cp313-cp313-manylinux_2_28_aarch64.whl
Size 6.1 MB
Tags CPython 3.13 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
8d0bc14923c7a62675bf5a19cf8e8ebee32bd592d60ff8f5d5739a7307376354
BLAKE2b-256 checksum
How to use checksums
6ee4cbab4db6daa4382efefc664ac58d7d9f0fd82fbe5e6c712fe9fd67147d6d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp313-cp313-macosx_13_0_arm64.whl

Download URL tensogram-0.24.0-cp313-cp313-macosx_13_0_arm64.whl
Size 5.4 MB
Tags CPython 3.13 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
6eed018c41f8a978d88fa5b2c76207e8958a721e2180912771619c0cc3a3f827
BLAKE2b-256 checksum
How to use checksums
7384f897df4c351896d0b6d15b0e36274e2ea0f76b86e4209b727c9db8e253b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL tensogram-0.24.0-cp312-cp312-manylinux_2_28_x86_64.whl
Size 6.1 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
4e9156a652e3658fcebd83c4bb85027f8afdd2bbce41b6f9d67c6270afcec5ec
BLAKE2b-256 checksum
How to use checksums
1854dfa2714f81781f6ea7b38f1f4821fcbf5b3e512705650644db5c59c56876
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp312-cp312-manylinux_2_28_aarch64.whl

Download URL tensogram-0.24.0-cp312-cp312-manylinux_2_28_aarch64.whl
Size 6.1 MB
Tags CPython 3.12 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
42d9eca0d04c2c70f102eb7fa69d6e66775c22e08c2cd29e1a65bc12e33c5ba1
BLAKE2b-256 checksum
How to use checksums
10adb9b98aa16717cf9565fe24e071b7afdb6b8400fef85964f604d5819a3907
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp312-cp312-macosx_13_0_arm64.whl

Download URL tensogram-0.24.0-cp312-cp312-macosx_13_0_arm64.whl
Size 5.4 MB
Tags CPython 3.12 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
1c58e60d2708138afd48b3cc982832a6e1842189b94911e6400b5b1f76966221
BLAKE2b-256 checksum
How to use checksums
1dc96b18c2ff67947dcb50aef653addf00b8f99f7b40fedc385844a769a05aa1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL tensogram-0.24.0-cp311-cp311-manylinux_2_28_x86_64.whl
Size 6.1 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
d6566fadaa22f4c7cc66d60704c746397558d4ea35e85b937f19cb956d89229e
BLAKE2b-256 checksum
How to use checksums
8a05619ac1bb9e13c6da8e15cd47b01a82231d7a5eff81df96fba7e38ce17800
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp311-cp311-manylinux_2_28_aarch64.whl

Download URL tensogram-0.24.0-cp311-cp311-manylinux_2_28_aarch64.whl
Size 6.1 MB
Tags CPython 3.11 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
bff2407c6ec9d1e800c24731d1020bf75655859cb88f940209d39ec421e25bb1
BLAKE2b-256 checksum
How to use checksums
034d56264c3a02bfff175e929ba16d54957f1c7e5a569fbf5f5bbf9910000c5e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / tensogram-0.24.0-cp311-cp311-macosx_13_0_arm64.whl

Download URL tensogram-0.24.0-cp311-cp311-macosx_13_0_arm64.whl
Size 5.4 MB
Tags CPython 3.11 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
98fb061a6deeefe4166b3e3fe33457b74053af08fceb2c900cfefd6097dc2ed6
BLAKE2b-256 checksum
How to use checksums
daa6aaf350817ed7792910816d5c7da01038345bdcc825a62f1e6aeea39b250b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.14

Security for tensogram 0.24.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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