Skip to main content

turboquant-mlx

turboquant-mlx packages a small MLX-oriented reference implementation of the TurboQuant building blocks described in arXiv:2504.19874:

  • orthogonal rotations
  • scalar codebooks
  • polar quantization for keys and values
  • a 1-bit QJL sketch
  • outlier channel handling

Installation

python -m pip install turboquant-mlx

For development:

python -m pip install -e ".[dev]"
pytest

Runtime requirements

The package depends on mlx and therefore targets Apple Silicon macOS environments where MLX is supported. The test suite uses a lightweight stub for mlx.core so package logic can still be validated in environments where the Metal runtime is unavailable.

Package contents

  • Rotation: fast Walsh-Hadamard or dense QR rotations
  • Codebook: scalar quantization codebooks and persistence helpers
  • PolarQuant: key/value encode-decode helpers
  • SplitTurboQuant: paper-style mixed-precision split quantization for 2.5/3.5-bit setups
  • QJL: 1-bit quantized Johnson-Lindenstrauss sketch
  • OutlierHandler: EMA-based outlier channel selection for routing channels into the higher-bit split quantizer

Metadata

Release files for turboquant-mlx 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for turboquant-mlx 0.1.0
File Size Uploaded
turboquant_mlx-0.1.0.tar.gz 11.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for turboquant-mlx 0.1.0
File Interpreter ABI Platform
turboquant_mlx-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 20.3 kB

Release files / turboquant_mlx-0.1.0.tar.gz

Download URL turboquant_mlx-0.1.0.tar.gz
Size 11.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e4b899fda39f14955b8ace2f5e78348038272d68ce20e048fbd9497f942ce011
BLAKE2b-256 checksum
How to use checksums
af02cb31e021417c8e949aee089b93057b689b376d7d54716788da7ff48e6e3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release files / turboquant_mlx-0.1.0-py3-none-any.whl

Download URL turboquant_mlx-0.1.0-py3-none-any.whl
Size 9.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
12589a77aea87f7d1046123a1c5d9cd8dfcaa3693adfaa924ea0990d784949a1
BLAKE2b-256 checksum
How to use checksums
d25b9e8635664626ff5851fd831da05f314b882d3ea0f7a4468bfb37cae138a0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

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