// guides

Step-by-step, no fluff

Short, practical guides that get you from install to a fixed OOM to a verified speedup — each a checklist you can follow in minutes.

beginner 5 minutes

Install the fast-axolotl shim

Add fast-axolotl to an existing Axolotl setup in minutes. Install the wheel, import before axolotl, and verify the Rust extension linked — no config diff.

intermediate 10 minutes

Fix Axolotl RAM OOM with Rust streaming

Stop Axolotl from OOM-killing on large datasets. Enable fast-axolotl streaming so peak RAM is bounded by batch size instead of dataset size.

intermediate 15 minutes

Verify the speedup on your dataset

Measure fast-axolotl on your own data. Toggle the shim off and on, time the read and dedupe stages, and see where Rust wins — and where FFI overhead does not.