pdbz199/turboquant-explained

turboquant-explained is a small companion code repository for a Medium article titled TurboQuant Is Simpler Than You Think, written by Preston Rozwood. The README does not explain what TurboQuant itself is or what problem it solves. It only says the code in this repository reproduces the qualitative results from the TurboQuant paper in a simple, readable way, and that it is meant to be read alongside the linked article rather than as a standalone explanation. To run the demo, you clone the repository, set up a Python virtual environment, install the dependencies listed in a requirements file, and run a single main script. That script writes out figures and metrics to an outputs folder, and the whole thing finishes in about one to two minutes on an ordinary laptop CPU, with no special hardware needed. Because the README is short and mostly points elsewhere for context, this project is best understood as a hands on companion to the Medium article rather than a project with its own documentation. Anyone curious about what TurboQuant actually does would need to read that article first, since this repository exists to let you reproduce and see its results for yourself rather than take them on faith. The README does not describe the internal algorithm, the file structure beyond the outputs folder, or a license, so none of that is covered here.