Reference
Commands
Crowkis is Redis-compatible on the wire: the standard commands behave the way you expect, and the C* family adds the semantic cache on top.
The semantic family#
| Command | What it does |
|---|---|
CSET | Store an answer with model, tenant, and TTL. The write passes intent classification, template extraction, and the anti-poisoning pipeline before it is accepted. |
CGET | Retrieve by meaning. Exact matches, paraphrases, and structural template matches all qualify — if the confidence score clears the intent's threshold. |
CGETSTREAM | Like CGET, but streams the cached answer in chunks — so cached responses feel like live model output. |
CIMGGET | Multimodal lookup for image + text queries. |
CSIM | Inspect the K nearest semantic neighbours of a query. Your debugging window into the vector index. |
CFLUSH | Flush semantic entries for a tenant. |
CDELETEENTRY | Delete a specific cached entry. |
CVECCOUNT | Count of vectors currently in the HNSW index. |
Anatomy of a CSET#
crowkis cli
CSET "What is your refund window?" \
"Refunds are issued within 5 business days of approval." \
EX 86400 \
MODEL gpt-4o \
TENANT support| Part | Meaning |
|---|---|
query | The question, stored both as an embedding and as an abstracted structural template. |
answer | The response to cache. |
EX seconds | TTL. Freshness policies can shorten effective reuse further. |
MODEL name | Which model produced this — used for migration and canary workflows. |
TENANT id | Isolation boundary. Entries never cross tenants. |
Standard Redis commands#
Supported over RESP2/RESP3 (negotiated via HELLO):
| Group | Commands |
|---|---|
| Connection | PING · ECHO · HELLO · AUTH · QUIT · RESET |
| Key-value | GET · SET · GETSET · DEL · EXISTS · TTL · KEYS · TYPE · STRLEN · GETDEL · GETEX · GETRANGE · SETRANGE · INCR · INCRBY · INCRBYFLOAT · APPEND · MGET · MSET · SCAN · DBSIZE · RENAME |
| Expiry | EXPIRE · PEXPIRE · PERSIST · PTTL |
| Server | INFO · COMMAND · CONFIG · FLUSHDB · FLUSHALL · LASTSAVE · TIME · BGSAVE · BGREWRITEAOF · COMPACT · SWEEP · STATS |
Frame limits are enforced at the protocol layer: 1024 arguments, 64 MB per bulk string, 128 MB per frame. RESP and gRPC traffic require
CROWKIS_AUTH_TOKEN when set, compared in constant time.gRPC surface#
The gRPC API (h2c, RESP port + 2) exposes Get, Set, GetStream, Stats, and Invalidate — the same cache, for services that prefer protobuf contracts. The schema lives at proto/crowkis.proto in the repository.