← Back to Skills Marketplace
sunnyztj

TurboQuant Memory

by SunnyZhou · GitHub ↗ · v2.0.0 · MIT-0
cross-platform ⚠ suspicious
153
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install turboquant-memory
Description
Compress and accelerate vector search in memory/RAG systems using TurboQuant (ICLR 2026) — near-optimal vector quantization with 5-8x compression and 98%+ se...
Usage Guidance
This skill mostly does what it says: local numpy-based quantization and migration of embeddings into a new SQLite table. Before running it on important data: (1) Back up any database you pass to migrate — the script creates a quantized_embeddings table and uses INSERT OR REPLACE which can overwrite rows. (2) Review the code locally: there are inconsistencies (SKILL.md/refs say blockwise Hadamard and warn against SRHT, but some modules/imports mention SRHTRotate or SRHT; some functions use type names like List/Dict without importing typing) — these may cause runtime errors or indicate the docs and code are out-of-sync. (3) Run the bundled tests (python3 scripts/turboquant.py) and validate on a small copy of your data (python3 scripts/validate.py --db /path/to/copy.db --auto-detect) to confirm behavior and metrics. (4) Prefer running migrate on a copied DB or staging environment. If you are not comfortable auditing Python code yourself, ask the author for clarification about the SRHT vs blockwise Hadamard mismatch and for guarantees about non-destructive migration and deterministic seeds.
Capability Analysis
Type: OpenClaw Skill Name: turboquant-memory Version: 2.0.0 The bundle provides a legitimate and well-implemented vector quantization tool based on the TurboQuant algorithm for compressing embeddings in SQLite-based RAG systems. The code (turboquant.py, memory_quantize.py, validate.py) performs mathematical transformations (Fast Walsh-Hadamard Transform, Lloyd-Max quantization) and database operations consistent with its stated purpose. It lacks any high-risk behaviors such as network access, shell execution, or data exfiltration. While the metadata and documentation contain future-dated references (e.g., ICLR 2026, arXiv 2025), the implementation is technically sound, transparent, and contains no evidence of malicious intent or prompt injection.
Capability Assessment
Purpose & Capability
Name, description, SKILL.md and the scripts all align: this is a local numpy-based implementation of a vector quantizer that detects SQLite embedding tables, quantizes embeddings, and writes results to a new 'quantized_embeddings' table. The required capabilities (none) are proportionate to the stated purpose.
Instruction Scope
The runtime instructions and scripts will scan arbitrary SQLite databases (auto-detect tables), read embeddings and text columns, and create/insert into a quantized_embeddings table using INSERT OR REPLACE. This is expected for a migration/quantize tool, but it means the skill will modify user databases. Also, SKILL.md and references disallow SRHT (lossy SRHT) while some code and imports reference SRHTRotate/SRHT — there is an inconsistency between the written docs and code which could cause unexpected behavior or indicate the code and docs are out of sync.
Install Mechanism
There is no install spec (instruction-only with bundled scripts). No network downloads, no external package installs beyond numpy — low install risk.
Credentials
The skill requests no environment variables or credentials. That is proportionate. However, the scripts require read/write access to whatever SQLite DB path you point them at; they will create/modify tables and can overwrite entries (INSERT OR REPLACE).
Persistence & Privilege
The skill is not always:true and does not ask for persistent system privileges. It will persist data into the target SQLite DB (creates quantized_embeddings and writes records). That behavior is expected but impactful — backups are recommended before running migrations.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install turboquant-memory
  3. After installation, invoke the skill by name or use /turboquant-memory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
v2: Blockwise Hadamard rotation (fixes critical SRHT subsample bug), 98% recall at 6.4x compression, numpy only, OpenClaw sqlite-vec support, distribution validation tool
v1.1.0
Default bits changed from 4 to 6 based on real-world testing. b=6 achieves 98% top-1 recall with 5.3x compression (vs 86% at b=4). Added benchmark data for b=4 through b=8.
v1.0.0
Initial release: TurboQuant vector quantization for memory/RAG systems. 6-8x embedding compression, 87%+ top-1 recall, based on ICLR 2026 paper.
Metadata
Slug turboquant-memory
Version 2.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is TurboQuant Memory?

Compress and accelerate vector search in memory/RAG systems using TurboQuant (ICLR 2026) — near-optimal vector quantization with 5-8x compression and 98%+ se... It is an AI Agent Skill for Claude Code / OpenClaw, with 153 downloads so far.

How do I install TurboQuant Memory?

Run "/install turboquant-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is TurboQuant Memory free?

Yes, TurboQuant Memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does TurboQuant Memory support?

TurboQuant Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created TurboQuant Memory?

It is built and maintained by SunnyZhou (@sunnyztj); the current version is v2.0.0.

💬 Comments