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.4

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

Total release size: 154.1 MB

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

Download URL cat_surf-1.1.4-cp315-cp315-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 8.7 MB
Tags CPython 3.15 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
5b4c13294419655224559d6f0bf21822116ff505a8e217b67625649caf2a16a6
BLAKE2b-256 checksum
How to use checksums
c3c94a847623816309dda2dafa52665e5fbb65acbd8ec037f5e669f0bf8fc574
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp315-cp315-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 8.5 MB
Tags CPython 3.15 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
20107bdea6a1a06f08973868afcd19e4d5d201175cc1e851850a25f7cfdd90a7
BLAKE2b-256 checksum
How to use checksums
017520c3ebed4216031f9755c7264330ecaf0df7d5e599bc1090ac0bbe58d391
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp315-cp315-macosx_11_0_arm64.whl
Size 5.0 MB
Tags CPython 3.15 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
b6d225744404f17944156302ce53acc59b36ab1c089d5a17ff68e25e3a301310
BLAKE2b-256 checksum
How to use checksums
3eb20b44dc5e3fadaedafe20e9614df489ee60598b339f3d5750623ac58ffd77
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 8.7 MB
Tags CPython 3.14 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
a61363496667878ae20cfc0eeefcd585c32df16bf0d45200d0ce8d41632c2147
BLAKE2b-256 checksum
How to use checksums
2073076cf2145dcea254ebf5d418c157d45f6b7b7214206836703f651c3c8a06
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 8.5 MB
Tags CPython 3.14 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64
SHA-256 checksum
How to use checksums
e92266fb613972e27c528754b726be59b95d9d168e2ec3ee84be356d4b04c813
BLAKE2b-256 checksum
How to use checksums
8ad5fede8815e564a4737fa4c931da6104bc59c4c808194432cf7ecb0245ac95
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp314-cp314-macosx_11_0_arm64.whl
Size 5.0 MB
Tags CPython 3.14 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
33f55fe43a4f9fafa8b7a8b131b23f1b41c292f55d85b617e731e17e18e37c29
BLAKE2b-256 checksum
How to use checksums
3d2b0198677902a9dad608f34590a645d7e871052e506649db48f18f81c4d3eb
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.6 MB
Tags CPython 3.13 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
70a8f511d11e0b16bd31e2c9c5991925ccad4d869c7c8222158d8969ed2fdb26
BLAKE2b-256 checksum
How to use checksums
61eb3174cd8620aa0d6d57144e009e5eae3b2c141254059994a2faa3d9e14b32
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.4 MB
Tags CPython 3.13 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
d939063d3304226fe5bfea134bde2667d4739d743432cfdf250852b2e7c38c7a
BLAKE2b-256 checksum
How to use checksums
7ad9cb4c505b78695dc77c09c797bace632bf6607154d97a07dca91579467083
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp313-cp313-macosx_11_0_arm64.whl
Size 5.0 MB
Tags CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
1e924416c7eea110c7aaa9200646909c9172dfefea12f62825e64ed1dc44f7c9
BLAKE2b-256 checksum
How to use checksums
2b63df03bf227336fa548da789fe4d778dc00c1934a8006e4bae07acf083633c
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.7 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
66fe7c6ee65c065d3e7452c8079b230e32d66d82d412b1f0e33561ccd575b1d2
BLAKE2b-256 checksum
How to use checksums
1aedbf97b6bd4dacbdb7b6176413f5d46837732d312d5862c146043c82e2c0e7
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.5 MB
Tags CPython 3.12 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
530b40a5fff82ec39bd4507e2ddc44a851dcf0e575a0e001de3dcc6b3a214efe
BLAKE2b-256 checksum
How to use checksums
03bd0e83615a989be7b6bd74dd8cb00fa591c4f22bc06f38c98f9c1b29b56450
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp312-cp312-macosx_11_0_arm64.whl
Size 5.0 MB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
14da5c03e1fc9fe75e83e554ec420ae82e00ada0c58640102a632431e8da3062
BLAKE2b-256 checksum
How to use checksums
886449905378b0c4ab00353a86faebd197ae2ca22610953e1d5c2d4c630e41c3
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.6 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
3df38caaef768a2ead749106b7c5cb5e6048a97c7871bc08f35c989b0e621393
BLAKE2b-256 checksum
How to use checksums
bcd85dbcd4d69708ec551099fa8bb9b75c2d3d5eaec50b90010fb6bf49d7dbf4
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.5 MB
Tags CPython 3.11 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
05950459476c59099b6ac03e9c7f79300a743f854fb7c05bd3f92c538b010e0c
BLAKE2b-256 checksum
How to use checksums
747ffd765ebd61a6076fddef4bdcf2a239fe78a5bacfaa9a8eaded3cd1c60e4e
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp311-cp311-macosx_11_0_arm64.whl
Size 5.0 MB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
644b934177e703114d4085b41345fba656ccc9eef0beb50b22f60141b3b00b12
BLAKE2b-256 checksum
How to use checksums
661d70bf5418359648f35d6fec503009acdbea5f02cbdeba54dae1d9e23cb345
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.5 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
daad13ad2fa0d0a6a5f5e48d78b3a3dd393c9fce0a9e78e56896ee0e3a7aca40
BLAKE2b-256 checksum
How to use checksums
6abe6d739b750f776005b8751fb97afef3f1722ec560cfeb486634d634b476ea
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.3 MB
Tags CPython 3.10 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
494ae9f0137feae59d016183b27455562432c0250b4fa66ef7cde9691a27d0f7
BLAKE2b-256 checksum
How to use checksums
1f3c973538f2f95b8056e92422170b96f600113f5fe8f8fe6fd11777182f76f9
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp310-cp310-macosx_11_0_arm64.whl
Size 5.0 MB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
1cbee35e2c0ead14399a80b92f116ec0c026601fe9616c797ab79b3497373cd8
BLAKE2b-256 checksum
How to use checksums
499a8d8c3190de4bc616b3d883fbffa71365c6d1c4ba24667df9175dd13a5434
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 8.5 MB
Tags CPython 3.9 Linux glibc 2.17+ x86-64
SHA-256 checksum
How to use checksums
a7ecb2dfb8bab02037d6421df22e3966bfa404cf5762638c2b89666fa781a20e
BLAKE2b-256 checksum
How to use checksums
eeb5e70f7df060dc847195df1ae36097c8306c948ff707e499b53a53337ae7f7
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 8.3 MB
Tags CPython 3.9 Linux glibc 2.17+ ARM64
SHA-256 checksum
How to use checksums
e5e52514a971e60a49d1552db161d3e429d8f518fe4879c157cd560e8e0c1b91
BLAKE2b-256 checksum
How to use checksums
bbedfb8aa1824cd8d049e44d51d19538774636dec19bdca7dc7b22f5003c7a84
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 23, 2026.

Transparency log

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

Download URL cat_surf-1.1.4-cp39-cp39-macosx_11_0_arm64.whl
Size 5.0 MB
Tags CPython 3.9 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
16eb41d1a92947a36514e0c3cefa9931ecedef4dc7f991cdcec83273158cc0ae
BLAKE2b-256 checksum
How to use checksums
91556356f5f5d16e74206837eece2660aa5458442fa7e6d71a191613975f0938
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 23, 2026.

Transparency log

Security for cat-surf 1.1.4

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.4-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 23, 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.4 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