Skip to main content

cat-surf — Python bindings for CAT-Surface

PyPI Python License: GPL-2.0

cat-surf provides Python access to CAT-Surface, a mature C/C++ toolkit for surface-based neuroimaging analysis, focusing on the processing and analysis of cortical surface meshes.

CAT-Surface has been used internally for more than 10 years as part of CAT12, the SPM toolbox for computational anatomy. With this package, it is now distributed as an independent Python package for direct integration into external workflows to make CAT-Surface easier to use:

  • in T1Prep workflows (currently relying on CAT-Surface binaries)
  • in Python-based pipelines without subprocess-heavy wrappers
  • in reproducible environments via published wheels

Installation

pip install cat-surf

Pre-built wheels are available for:

  • macOS — arm64 (Apple Silicon), x86_64 (Intel)
  • Linux — x86_64, aarch64 (manylinux)
  • Python 3.9 – 3.15

Building from source

The extension modules are generated from the .pyx sources at build time; the intermediate .c files are build artifacts and are not tracked in the repository. Cython is declared in build-system.requires, so any PEP 517 build installs it for you:

# build libCAT first (see the CAT-Surface README), then:
pip install ./cat_surface_cython

For an in-place development build, Cython has to be in the ambient environment and libCAT has to be findable:

pip install cython
CAT_BUILD_DIR=/path/to/CAT-Surface python setup.py build_ext --inplace

Note that this regenerates every .c file, so a Cython version that differs from the one used elsewhere changes all of them — harmless now that they are untracked, but it is why they are not kept in git.


Basic usage

import cat_surf

# Check version
print(cat_surf.__version__)

# Load a surface file (GIFTI, FreeSurfer, BIC/MNI formats)
vertices, faces = cat_surf.read_surface("lh.central.gii")

# Per-vertex area
area, total_area = cat_surf.get_area(vertices, faces)

# Euler characteristic
chi = cat_surf.euler_characteristic(vertices, faces)

# Everything at once (mirrors CAT_SurfInfo); skip the expensive
# self-intersection test with check_intersections=False
info = cat_surf.surf_info(vertices, faces)
print(info["euler"], info["genus"], info["surface_area"],
      info["n_self_intersections"])

# Smooth per-vertex data (heat kernel, FWHM in mm)
smoothed = cat_surf.smooth_heatkernel(vertices, faces, area, fwhm=20.0)

Surface operations

Function Description Mirrors
read_surface / write_surface Multi-format surface I/O (GIFTI, FreeSurfer, BIC) —
read_values / write_values Per-vertex scalar I/O —
get_area Per-vertex and total surface area CAT_SurfArea
get_area_normalized Area normalized by a reference sphere CAT_SurfArea -sphere
euler_characteristic Topological integrity check —
surf_info Full geometry/topology summary as a dict: V/F/E, Euler, genus, components, area, volume, bounding box, self-intersections CAT_SurfInfo
read_gifti_darrays List the DataArrays a .gii embeds next to the mesh, with value range and NaN count —
smooth_heatkernel Heat-kernel smoothing of per-vertex data —
smooth_mesh Laplacian/Taubin mesh vertex smoothing —
smoothed_curvatures Mean curvature estimation —
sulcus_depth Sulcal depth via depth potential —
reduce_mesh Quadric (QEM) mesh decimation (aggressiveness, preserve_sharp) CAT_SurfReduce
fix_self_intersect Self-intersection repair (topology preserving) CAT_SurfFixSelfIntersect
count_intersections Count intersecting triangle pairs CAT_SurfSelfIntersect
surf_average Vertex-wise averaging across surfaces (return_rms for std dev) CAT_SurfAverage
surf_to_sphere Inflate surface to sphere CAT_Surf2Sphere
sphere_radius Mean radius of a spherical surface —
correct_thickness_folding Folding-based thickness correction (slope, max_dist clipping) CAT_SurfCorrectThicknessFolding
point_distance Linked vertex distance between two meshes CAT_SurfDistance -link
point_distance_mean Mean (Tfs) vertex distance CAT_SurfDistance -mean
hausdorff_distance Hausdorff distance between two surfaces —
resample_to_sphere Resample surface/values onto a target sphere CAT_SurfResample
surf_deform Deform a surface toward a volume isovalue CAT_SurfDeform
surf_to_pial_white Estimate pial + white surfaces from a central surface; the pial surface is placed by profile search (pial_profile), remove_intersect repairs both CAT_Surf2PialWhite
central_to_pial Generate a pial surface from central + thickness —
spherical_demon Spherical Demons spherical registration CAT_SurfSphericalDemon

Volume operations

Function Description Mirrors
vol_sanlm Structure-adaptive non-local means denoising CAT_VolSanlm
vol_blood_vessel_correction Blood vessel intensity correction (no CLI; the correction CAT_VolThicknessPbt applies unless -no-bvc)
vol_thickness_pbt Cortical thickness via projection-based method; unlike the binary it does not apply the blood-vessel correction first (see vol_blood_vessel_correction) CAT_VolThicknessPbt
vol_amap Adaptive maximum a posteriori tissue segmentation CAT_VolAmap (core only)
vol_marching_cubes Isosurface extraction with genus-0 topology correction CAT_VolMarchingCubes
vol_smooth Isotropic Gaussian volume smoothing CAT_VolSmooth
vol_calc Voxel-wise image calculator (spm_imcalc-style formula) CAT_VolCalc
vol_sheetness Multi-scale Hessian sheetness (plate) filter CAT_VolSheetness
vol_oriented_median Median over a sheetness-oriented neighbourhood CAT_VolLocalStat -oriented
vol_open_ppm_sulci Push buried sulcal valleys in a PPM below the isovalue CAT_VolMarchingCubes -strength-sulci
vol2surf Map a volume to a surface along inward normals CAT_Vol2Surf

Thin structures and the shrinking bias

Every isotropic regularizer — a local median, a Potts MRF, total variation — penalizes boundary area, and a thin structure has an extreme area-to-volume ratio, so deleting it is always the cheaper labelling. That is why one and the same median filter opens glued sulci in one place and closes cerebellar fissures in another, and why tuning its strength only trades one failure for the other.

vol_sheetness replaces the smoothness prior with a shape prior read off the Hessian eigenvalues, so it keeps thin sheets, ignores blobs, and shrinks nothing. Everything below is built on it, and all of it is a no-op where the sheetness is zero — the oriented operators are numerically identical to the isotropic ones they replace away from thin structures, so they are safe to switch on:

import cat_surf, nibabel as nib

t1  = nib.load("t1_corr.nii").get_fdata().astype("float32")
lab = nib.load("label.nii").get_fdata().astype("float32")
vx  = nib.load("label.nii").header.get_zooms()[:3]

# Inspect the evidence first: dark sheets are sulcal CSF, bright ones WM blades
sheet, normal = cat_surf.vol_sheetness(t1, voxelsize=vx, polarity=-1,
                                       return_normal=True)

# A median that cannot close a sulcus (orientation taken from the intensity)
clean = cat_surf.vol_oriented_median(lab, guide=t1, voxelsize=vx)

# the medians inside PBT are sheetness-oriented by default
gmt, ppm, _, _ = cat_surf.vol_thickness_pbt(lab, voxelsize=vx)

# The T1 is gone by the surface stage, but the PPM carries the geometry:
# a sulcus is a valley in it and a gyral blade a ridge, so the same filter
# finds buried sulci without any intensity image
ppm = cat_surf.vol_open_ppm_sulci(ppm, voxelsize=vx, isovalue=0.5)

Volume input convention

Every volume-consuming function accepts three input forms interchangeably:

import cat_surf, nibabel as nib
import numpy as np

# 1. file path
v, f = cat_surf.vol_marching_cubes("brain.nii.gz", threshold=0.5)

# 2. (ndarray, affine) tuple — supply a 4×4 RAS+ affine
v, f = cat_surf.vol_marching_cubes((array, affine), threshold=0.5)

# 3. any nibabel-image-like object (.affine + .get_fdata())
v, f = cat_surf.vol_marching_cubes(nib.load("brain.nii.gz"), threshold=0.5)

The data is auto-converted to float32 (matching the C library's expectation), and 4-D series default to the middle frame. No copy is made if the array is already float32/Fortran-order. Internally a minimal nifti_image is built from the affine — only the fields libCAT actually reads (dims, voxel sizes, sto_xyz).

Registration

Function Description
bbreg Full BBR pipeline: optional NMI init → boundary-based surface registration, rigid or with scales / shears (dof=9 / dof=12)
bbreg_detect_contrast Auto-detect T1/FLAIR vs T2/BOLD from WM/GM intensity ratio
volume_register_nmi Cross-modal rigid registration via Normalised Mutual Information (≈ mri_coreg)
volume_register_robust Same-modality rigid registration via Tukey biweight M-estimation (≈ mri_robust_register --iscale)
vol_realign Head-motion correction of a 4-D series in mcflirt's conventions (≈ mcflirt)

Basic BBR usage

import cat_surf
import nibabel as nib

# Load surfaces (GIFTI or any format supported by cat_surf.read_surface)
lh_verts, lh_faces = cat_surf.read_surface("lh.white.surf.gii")
rh_verts, rh_faces = cat_surf.read_surface("rh.white.surf.gii")

# Full pipeline: NMI init from T1w reference, then BBR
matrix, cost = cat_surf.bbreg(
    "bold_mean.nii.gz",
    lh_surface=(lh_verts, lh_faces),
    rh_surface=(rh_verts, rh_faces),
    ref_file="T1w.nii.gz",     # NMI initialisation
    verbose=True,
)
print(f"BBR cost: {cost:.4f}")
print("EPI → T1 matrix:\n", matrix)

# Save the 4×4 world-space (RAS-to-RAS) transform.  This is not the
# convention of flirt -init (FSL's scaled voxel coordinates; see
# CAT_SurfBBReg -fsl-matrix) nor an ITK transform for ANTs.
import numpy as np
np.savetxt("epi_to_t1.txt", matrix)

# Scales (dof=9) or scales and shears (dof=12) refine the rigid result, e.g.
# for distortion a rigid transform cannot absorb.  The BBR contrast peaks
# where the boundary lies midway between the WM and GM samples, so with
# wm_dist larger than the GM offset the scales come out slightly too large.
matrix, cost = cat_surf.bbreg(
    "bold_mean.nii.gz",
    lh_surface=(lh_verts, lh_faces),
    rh_surface=(rh_verts, rh_faces),
    ref_file="T1w.nii.gz",
    dof=9,
)

Standalone volume registration

# Cross-modal (EPI ↔ T1w) — NMI
matrix, nmi = cat_surf.volume_register_nmi("T1w.nii.gz", "bold_mean.nii.gz")

# Same-modality (T1w ↔ T1w) — robust IRLS; a global intensity scale is
# estimated along with the motion (iscale=True)
matrix, res = cat_surf.volume_register_robust("t1_ref.nii.gz", "t1_moving.nii.gz")

Head-motion correction (mcflirt replacement)

# What fMRIPrep's head-motion workflow asks of mcflirt
#   mcflirt -in bold -out bold_mcf.nii.gz -reffile boldref -mats -plots -rmsabs -rmsrel
# with the same files: bold_mcf.nii.gz, bold_mcf.nii.gz.mat/MAT_%04d,
# bold_mcf.nii.gz.par, bold_mcf.nii.gz_{abs,rel}{,_mean}.rms
from cat_surf import cli
res = cli.vol_realign("bold.nii.gz", "bold_mcf.nii.gz", reffile="boldref.nii.gz",
                      mats=True, plots=True, rmsabs=True, rmsrel=True)

# In memory: transforms (world and FSL), mcflirt's parameters, RMS displacements
res = cat_surf.vol_realign(series_4d, affine, ref=boldref, ref_affine=affine)
res["par"]       # (nt, 6) rx ry rz (rad) tx ty tz (mm), as mcflirt's .par
res["fsl"]       # (nt, 4, 4) volume -> reference, as mcflirt's MAT files

Contrast auto-detection

# 0 = T1/FLAIR, 1 = T2/BOLD, -1 = undetermined
contrast = cat_surf.bbreg_detect_contrast(
    "bold_mean.nii.gz",
    lh_surface=(lh_verts, lh_faces),
    rh_surface=(rh_verts, rh_faces),
)

Conversion utilities

Function Description
arrays_to_polygons Convert NumPy vertex/face arrays to internal polygon mesh
polygons_to_arrays Convert internal polygon mesh back to NumPy arrays

cat_surf.cli — drop-in replacement for the CAT binaries

The cat_surf.cli subpackage mirrors the CAT_* command-line binaries one-to-one: same names (snake_case, CAT_ prefix dropped), same positional argument order, same option semantics and defaults. Each function reads its inputs from disk, calls the in-memory numpy wrapper, and writes the outputs — ideal for porting shell scripts to Python.

from cat_surf import cli

# CAT_VolMarchingCubes brain.nii.gz brain.gii -thresh 0.5
cli.vol_marching_cubes("brain.nii.gz", "brain.gii", threshold=0.5)

# CAT_Surf2PialWhite -remove_intersect central.gii thickness.txt labels.nii \
#     pial.gii white.gii
cli.surf2pial_white("central.gii", "thickness.txt", "labels.nii",
                    "pial.gii", "white.gii", remove_intersect=True)

# CAT_SurfDistance -mean surf1.gii surf2.gii out.txt
cli.surf_distance("surf1.gii", "surf2.gii", "out.txt", mode="mean")

# CAT_VolSanlm in.nii out.nii -strength 1.0
cli.vol_sanlm("in.nii", "out.nii", strength=1.0)

The full mapping:

CAT binary cat_surf.cli.<name>
CAT_Surf2PialWhite surf2pial_white
CAT_Surf2Sphere surf2sphere
CAT_SurfArea surf_area
CAT_SurfAverage surf_average
CAT_SurfCorrectThicknessFolding surf_correct_thickness_folding
CAT_SurfDeform surf_deform
CAT_SurfDistance surf_distance
CAT_SurfInfo surf_info
CAT_SurfReduce surf_reduce
CAT_SurfFixSelfIntersect surf_fix_self_intersect
CAT_SurfResample surf_resample
CAT_SurfSphericalDemon surf_spherical_demon
CAT_Vol2Surf vol2surf
CAT_VolAmap vol_amap
CAT_VolCalc vol_calc
CAT_VolLocalStat vol_local_stat (-oriented only)
CAT_VolMarchingCubes vol_marching_cubes
CAT_VolRealign vol_realign (mcflirt's flags as keywords: reffile, refvol, mats, plots, rmsabs, rmsrel)
CAT_VolSanlm vol_sanlm
CAT_VolSheetness vol_sheetness
CAT_VolSmooth vol_smooth
CAT_VolThicknessPbt vol_thickness_pbt (applies the blood-vessel correction like the binary; blood_vessel_correction=False is -no-bvc)

For composable in-memory pipelines, prefer the lower-level cat_surf API directly — the CLI shims are just thin convenience wrappers.


Typical use cases

  • Cortical mesh processing (resampling, smoothing, metrics)
  • Thickness and folding related computations
  • Volume-to-surface projection
  • Denoising and volume preprocessing for structural MRI

Citation / provenance

If you use this package in research, please cite Dahnke et al., 2013 and mention the cat-surf package version for reproducibility.


Source

Metadata

Release files for cat-surf 1.1.5

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 cat-surf 1.1.5
File Actions
cat_surf-1.1.5-cp315-cp315-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.15 CPython 3.15 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for cat_surf-1.1.5-cp315-cp315-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
cat_surf-1.1.5-cp315-cp315-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl CPython 3.15 CPython 3.15 Linux glibc 2.28+ ARM64, Linux glibc 2.27+ ARM64 Details for cat_surf-1.1.5-cp315-cp315-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
cat_surf-1.1.5-cp315-cp315-macosx_11_0_arm64.whl CPython 3.15 CPython 3.15 macOS 11.0+ ARM64 Details for cat_surf-1.1.5-cp315-cp315-macosx_11_0_arm64.whl
cat_surf-1.1.5-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for cat_surf-1.1.5-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
cat_surf-1.1.5-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl CPython 3.14 CPython 3.14 Linux glibc 2.28+ ARM64, Linux glibc 2.27+ ARM64 Details for cat_surf-1.1.5-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
cat_surf-1.1.5-cp314-cp314-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 macOS 11.0+ ARM64 Details for cat_surf-1.1.5-cp314-cp314-macosx_11_0_arm64.whl
cat_surf-1.1.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ x86-64 Details for cat_surf-1.1.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
cat_surf-1.1.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ ARM64 Details for cat_surf-1.1.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
cat_surf-1.1.5-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details for cat_surf-1.1.5-cp313-cp313-macosx_11_0_arm64.whl
cat_surf-1.1.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ x86-64 Details for cat_surf-1.1.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
cat_surf-1.1.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ ARM64 Details for cat_surf-1.1.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
cat_surf-1.1.5-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for cat_surf-1.1.5-cp312-cp312-macosx_11_0_arm64.whl
cat_surf-1.1.5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ x86-64 Details for cat_surf-1.1.5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
cat_surf-1.1.5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ ARM64 Details for cat_surf-1.1.5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
cat_surf-1.1.5-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details for cat_surf-1.1.5-cp311-cp311-macosx_11_0_arm64.whl
cat_surf-1.1.5-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.17+ x86-64 Details for cat_surf-1.1.5-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
cat_surf-1.1.5-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.10 CPython 3.10 Linux glibc 2.17+ ARM64 Details for cat_surf-1.1.5-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
cat_surf-1.1.5-cp310-cp310-macosx_11_0_arm64.whl CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details for cat_surf-1.1.5-cp310-cp310-macosx_11_0_arm64.whl
cat_surf-1.1.5-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.9 CPython 3.9 Linux glibc 2.17+ x86-64 Details for cat_surf-1.1.5-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
cat_surf-1.1.5-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.9 CPython 3.9 Linux glibc 2.17+ ARM64 Details for cat_surf-1.1.5-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
cat_surf-1.1.5-cp39-cp39-macosx_11_0_arm64.whl CPython 3.9 CPython 3.9 macOS 11.0+ ARM64 Details for cat_surf-1.1.5-cp39-cp39-macosx_11_0_arm64.whl

Total release size: 159.3 MB

Release files / cat_surf-1.1.5-cp315-cp315-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL cat_surf-1.1.5-cp315-cp315-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 9.0 MB
Tags CPython 3.15 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
1684879b8229c35f835d1acd8a87bf9a8a55f31689b0108a3d0c27d76fa02038
BLAKE2b-256 checksum
How to use checksums
5ac355baf0f518e471d1160c98f90bbd366fbdd80df0f59d49f5d139c32f1bab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp315-cp315-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL cat_surf-1.1.5-cp315-cp315-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 8.8 MB
Tags CPython 3.15 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
00c03a508613bd77f0a45a9f70bff92c4faeb43d6d08ccf7a003f0b66a924940
BLAKE2b-256 checksum
How to use checksums
f100e95384f2c531d0c9d543eaa7f2dcc84919d22b6189a6b86dcac4bafbae0c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp315-cp315-macosx_11_0_arm64.whl

Download URL cat_surf-1.1.5-cp315-cp315-macosx_11_0_arm64.whl
Size 5.1 MB
Tags CPython 3.15 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
c8bcd667de6960c75285e6eb58864e0911b32a8d0f7c66f652beae11114218f0
BLAKE2b-256 checksum
How to use checksums
6fd75e5436fbdd09dd0cb3588a0f4b665203bae431c337ce5df964ed7fed4f64
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL cat_surf-1.1.5-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 9.0 MB
Tags CPython 3.14 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
e7ff0f42359ef8bb3f5f2fb7a6b02eb4104133f3b5730d43a9109219c867c67c
BLAKE2b-256 checksum
How to use checksums
f40afddffe184af5397e7b478e9f998b2ff50c891e64702b712d7b6542b1dc72
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL cat_surf-1.1.5-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 8.8 MB
Tags CPython 3.14 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
8235a4eedf4c60e22555aed79928e1e07a0e0ef1e54b143a64a8ae64ccbd3cf1
BLAKE2b-256 checksum
How to use checksums
4551797fe399917b215708f1c03b14f8907d2fce1fc5742f7046e73d63a4db0d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp314-cp314-macosx_11_0_arm64.whl

Download URL cat_surf-1.1.5-cp314-cp314-macosx_11_0_arm64.whl
Size 5.1 MB
Tags CPython 3.14 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
642d3a4120317770033c5e2a68188affe321ede16567a0dd4eb48c458a66fe70
BLAKE2b-256 checksum
How to use checksums
c2b018503417eb897625bdea6bc94ea0a33d4433140d32f768a7840d85d7eaa5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL cat_surf-1.1.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.9 MB
Tags CPython 3.13 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
8abc360106fa1bf901ce048630559c035866df211f0ad5ab3c3fba3ac553153e
BLAKE2b-256 checksum
How to use checksums
04e6eb7733de03e235bb3952f2b9531cb7ed71df4fd45116f740963a52be0d39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL cat_surf-1.1.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.7 MB
Tags CPython 3.13 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
62e6399e34037f9bc23ff9da754d1a637752f1a9769959ad26bac650d619eccd
BLAKE2b-256 checksum
How to use checksums
e1f0fb7b34ce553805deec91ca2ca890628bf87ec165bfb9b9cf77dbf8eaa8d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp313-cp313-macosx_11_0_arm64.whl

Download URL cat_surf-1.1.5-cp313-cp313-macosx_11_0_arm64.whl
Size 5.1 MB
Tags CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
40cbd3281816c0fe95796200dc17eed9b0da8ffb5b3e7dd6ef66e3c8835b6d12
BLAKE2b-256 checksum
How to use checksums
a56847f07439248b344f0c1d5ab8097c48433178d95b6cf54c8e22acf0ef7cda
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL cat_surf-1.1.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 9.0 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
c3272c954ecbb0c53884da8c779b8e54524205b5e78ed58a90d290562d0040ad
BLAKE2b-256 checksum
How to use checksums
d1007b9cd74a99f58f76add1bdd8696f7b0a8c97db332a836e2839217a62742b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL cat_surf-1.1.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.8 MB
Tags CPython 3.12 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
34a0b6b8658b9e7524428f9edccd2b8a40e185981c15990ebe3142cf977822c6
BLAKE2b-256 checksum
How to use checksums
7519ff82831f2557749c4a4ed216a134d717f7ce48067a1fc708da0fb2c7692a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp312-cp312-macosx_11_0_arm64.whl

Download URL cat_surf-1.1.5-cp312-cp312-macosx_11_0_arm64.whl
Size 5.1 MB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
ae215587bf54265f3abf214cce97f4eec8b6fc95c5e35969129a0ef67ed3991f
BLAKE2b-256 checksum
How to use checksums
062925fa80644369b4038a9fab342a2b064c09b138fa8c5c3a387827670a457a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL cat_surf-1.1.5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.9 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
4059069f6289d2357c9049f69f223910d6d5c69b5df46f6922af4593a8edbe87
BLAKE2b-256 checksum
How to use checksums
1b4745e0df3a4fd635d3cec0c12f7f2d028f37e2ef5d8630b8912f90ee642f98
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL cat_surf-1.1.5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.8 MB
Tags CPython 3.11 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
46ae49df324869e3f554bcf5e4c7514121071645add33eb703b06caf6d304234
BLAKE2b-256 checksum
How to use checksums
30943f6be1f6f338f7515b118e1ed241cc17c5750c1fef1868c2a54503f63976
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp311-cp311-macosx_11_0_arm64.whl

Download URL cat_surf-1.1.5-cp311-cp311-macosx_11_0_arm64.whl
Size 5.1 MB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
55e7ff44cf0b7465cf2e8bd38ec87f884fa795c6dac1ac05931e0fe85e42204d
BLAKE2b-256 checksum
How to use checksums
86604effcc36c2d3ffdcae8e81b9b06d99d54e50349ee798d21c1d9faffa3c99
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL cat_surf-1.1.5-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.8 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
a0ac16979cb6759a29aab20f8428e811845ef211a913198a2f32474b08b1466e
BLAKE2b-256 checksum
How to use checksums
e879e3a117ab5ea202bde96a0db536fc82686305776c802fa297334395905794
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL cat_surf-1.1.5-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.6 MB
Tags CPython 3.10 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
41ce33fbf8fbfcb2f97904b252cf8eada0b8f33a5c468e242665a0985c2fa634
BLAKE2b-256 checksum
How to use checksums
7ee8e3f3eef01e02d247de5c08209301c3f0083dc0a07ad5048a4209e86f7746
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp310-cp310-macosx_11_0_arm64.whl

Download URL cat_surf-1.1.5-cp310-cp310-macosx_11_0_arm64.whl
Size 5.1 MB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
318cab64651a6fb861a9dd26747f7217c31ba43d726385988d17a8ea6b13f8b3
BLAKE2b-256 checksum
How to use checksums
dd2212796ef6e21ec34725c570ed6c14597661edb9c652fd2d8be828be4951c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL cat_surf-1.1.5-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.8 MB
Tags CPython 3.9 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
7cda261b0798d542e10442cbcfcee796bbf574f43585d6c8c089085ca66d3685
BLAKE2b-256 checksum
How to use checksums
25238a67e1c0292c65245241f8c5bc4f9335286d43520cd887b3517c9ad517b9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL cat_surf-1.1.5-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.6 MB
Tags CPython 3.9 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
62f449f09aaffe12fb9a804a19fea9b326b86ac11c91a0b676bffbc73f56894a
BLAKE2b-256 checksum
How to use checksums
110796bc2fe4af10f0967ff98324726114d78eddd9e40c160fffca702d01e7f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Release files / cat_surf-1.1.5-cp39-cp39-macosx_11_0_arm64.whl

Download URL cat_surf-1.1.5-cp39-cp39-macosx_11_0_arm64.whl
Size 5.1 MB
Tags CPython 3.9 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
decc37a7a7208dc80696b36b6b1fbc92aaddadc549487952544ef7e01f232b75
BLAKE2b-256 checksum
How to use checksums
ac88363c56d44ce32854d52d4a242ace3809b91fc7ba6c0cdd1da6f2a95fc6a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Oct 26, 2026.

Transparency log

Security for cat-surf 1.1.5

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.

Full provenance

All 21 files in this release have been uploaded with provenance metadata.

Select from 21 files

Attestation for cat_surf-1.1.5-cp315-cp315-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

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 Oct 26, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

1.1.5 This release

21 release files Full provenance

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