turbovec
Installation
SKILL.md
turbovec operator
Instructions
- Check the actual checkout and source pin. From the jeo-skills repository root run
python3 .agent-skills/turbovec/scripts/preflight.py --repo /absolute/upstream --json; from an installed copy, use itsscripts/preflight.py. No--repomeans inventory only. The helper checks selected pinned-file hashes, not Git HEAD, the entire source tree, dependency installation, or execution. See pinned source notes. - Choose the library surface. Python imports
TurboQuantIndexorIdMapIndexfromturbovec; Rust uses theturboveccrate. This is an in-process vector index that linearly scans its compressed vectors. It does not provide a server, replication, tenancy, or distributed index. - Validate data shape and quality needs. Confirm vector dimension, row-major
float32input for Python, bit width (2 or 4), score semantics (inner product; normalize for cosine), recall target, and whether stable IDs are needed. Compare recall on representative local data before adopting quantization. - Get approval before effects. Ask before installing the package/toolchain, downloading models or vector datasets, reading/embedding private source data, using paid/remote embeddings, writing/syncing/loading an index file, rebuilding or deleting an index, or starting an API/service around it. Keep file paths and credentials out of public logs.
sync(path)persists data and later calls update it. - Check the pinned API and verify round-trip. After approval, inspect the checkout's Python/Rust API docs and package help. Start with a small fixture, verify search results and persistence/load, and measure memory, recall, and latency for the target machine. Do not infer production service readiness from an in-memory library smoke test.
Examples
# Offline provenance check; absolute, non-symlink source checkout.
python3 .agent-skills/turbovec/scripts/preflight.py --repo /work/turbovec --json