Expand description
skeg-cli - operator tools for skeg.
Three subcommands ship in v0.1:
build- offline Vamana index builder. Reads a vector dataset (.npyor.fbin) and writes a ready-to-serve skeg data directory. Seebuild_index.inspect- offline introspection of a data directory: VINDEX names, dims, vector counts, file sizes per shard. Seeinspect.stats- RESP3 client that fetchesSKEG.STATS,SKEG.SHARDS, andSKEG.VINDEX.LISTfrom a running server. Seestats.
The build output layout mirrors a single-shard data directory:
<output>/shard-0/vindexes.registry
<output>/shard-0/vindex-<name>/graph.vmn
<output>/shard-0/vindex-<name>/vectors.binModules§
- inspect
- Offline inspection of a skeg data directory.
- stats
- Minimal RESP3 client for the
skeg-cli statssubcommand.
Structs§
- Build
Stats - Summary of a completed offline build.
Functions§
- build_
index - Read a dataset from
inputand build a ready-to-serve index underoutput. - build_
index_ from - Build a Vamana index over an already-loaded dataset and write it under
outputas a ready-to-serve data directory. - read_
header - Parse only the format header of
path, returning(byte_offset, n, dim): where the f32 payload begins and its shape. The payload itself is not read, so a large dataset is not pulled into the heap. - read_
vectors - Read a row-major f32 dataset, returning
(data, n, dim).