Guides

Task-oriented walkthroughs for compressing, decompressing, and integrating PTWM.

Task-oriented walkthroughs. Pick the integration that fits your workflow.

Guide	What you get
CLI usage	Compress and decompress files from the terminal.
Python API	`Compressor`, `Decompressor`, configuration knobs.
Writing your first extension	Scaffold, build, sign, and install a custom codec end-to-end.
Trust and security	Keyring management, capabilities, policy files, and the threat model.
safetensors integration	`patch_safetensors()` makes existing safetensors loaders transparent to `.ptwm`.
HuggingFace transformers	`patch_transformers()` for non-safetensors HuggingFace checkpoints.
Random access	Open a `.ptwm` and fetch tensors by name without decompressing the whole bundle.
Tuning compression for a model	Run the chain explorer to extend the chain set for your checkpoint; cache, share, and import discovered chains.

Spherical Normalize

Per-row unit-vector reparameterization with an exact XOR residual.

CLI usage

Compress and decompress files with the `ptwm` command-line tool.