Skip to content

cudackpt 0.1.0

Choose a tag to compare

@thedhruvhegde thedhruvhegde released this 25 Jun 17:23

cudackpt 0.1.0

First public release — checkpoint and restore single-GPU CUDA processes on Linux without modifying your application.

What it does

cudackpt combines an LD_PRELOAD CUDA Driver API shim with CRIU process checkpointing. The control plane snapshots GPU allocations, streams, and modules into a versioned on-disk image, then restores CPU and GPU state together.

Install

From source (recommended on GPU hosts):

git clone https://github.com/DDVHegde100/cudackpt.git
cd cudackpt
git checkout v0.1.0
make && sudo make install

Debian/Ubuntu package (attached when available):

sudo dpkg -i cudackpt_0.1.0_amd64.deb

Highlights

  • Transparent CUDA interception via LD_PRELOAD
  • Versioned GPU images with CRC32C integrity checks
  • Optional compression, sparse pages, dedup, and delta snapshots
  • Full CLI: checkpoint, restore, rollback, inspect, validate, report
  • Prometheus metrics via cudackpt agent and systemd units
  • Optional RPC shared-secret auth (CUDACKPT_RPC_SECRET)

Requirements

Linux x86_64 · NVIDIA CUDA 12.x driver · CUDA toolkit · Go 1.22+ · CRIU 3.x

Documentation

Known limitations

Single GPU only · no MIG/NCCL/CUDA graphs · validate on your stack before production use