# zstd

> zstd, a magmalake tin: A Mojo binding to libzstd — one-shot and streaming, both directions — through a small C shim loaded at runtime, so consumers need no link flags.

[magmalake](https://magmalake.dev/) [zstd](https://magmalake.dev/s/zstd)

A Mojo binding to libzstd — one-shot and streaming, both directions — through a small C shim loaded at runtime, so consumers need no link flags.

Install

mojoshelf:

```
pixi shelf add zstd-mojo
```

`pixi shelf` comes with mojoshelf: [install it first](https://mojoshelf.org/getting-started).

plain pixi:

```
pixi init app -c https://conda.modular.com/max -c conda-forge && cd app
sed -i.bak 's/^\[workspace\]/[workspace]\npreview = ["pixi-build"]/' pixi.toml
pixi add "mojo-compiler==1.2.0"
# Without mojoshelf: the tin as a git dependency at its published commit.
# Transitive dependencies may be wrong: pixi takes the tin's own git deps as
# pinned in its pixi.toml, which may not match what other tins pin, and then
# fails with "duplicate records". mojoshelf picks revisions that agree.
pixi add zstd-mojo --git https://github.com/magmalake/zstd.mojo --rev 76190bb31012cd2d2f6712c4e1724a66474215db
```

No mojoshelf needed. If pixi reports duplicate records, the mojoshelf tab picks revisions that agree.

Version

`0.1.5` on mojoshelf

Source

[GitHub](https://github.com/magmalake/zstd.mojo) [README](https://github.com/magmalake/zstd.mojo#readme) [Benchmark history](https://magmalake.github.io/zstd.mojo/benchmarks/)

## Works today

- One-shot and streaming compress and decompress
- Frame introspection: is\_zstd\_frame, frame\_content\_size
- The shim is dlopen'd once, not per call

Checked against Python zstandard, against independently produced frames baked in as constants

- [thrift](https://magmalake.dev/s/thrift) compact + binary protocol
- [lz4](https://magmalake.dev/s/lz4) liblz4
- [brotli](https://magmalake.dev/s/brotli) libbrotli
- [snappy](https://magmalake.dev/s/snappy) pure Mojo
- [deflate](https://magmalake.dev/s/deflate) DEFLATE · gzip · pure Mojo
- [hashes](https://magmalake.dev/s/hashes) CRC-32 · murmur3 · XXH64
- [memory-region](https://magmalake.dev/s/memory-region) bytes addressed by offset · shared mappings
- [threads](https://magmalake.dev/s/threads) pthreads · atomics · parallel\_for
- [Every tin](https://magmalake.dev/tins)

[A magmalake project](https://magmalake.dev/)

Apache 2.0 · © 2026 Marius Seritan