Redis Vector — Hash + RediSearch index — every run becomes a Redis 8 hash.

What it does

[Redis](https://redis.io) 8 ships [RediSearch](https://redis.io/docs/latest/develop/interact/search-and-query/) as a first-class module — full-text + vector search over hashes. This sink writes one hash per peepshow run (`<index>:<runId>`) and issues `FT.CREATE … IF NOT EXISTS` on first run so a paired full-text/vector index is materialised lazily. It shells out to the system `redis-cli` (no Node client dependency, zero install for users who already run Redis) and passes the password via stdin's `AUTH` command so secrets never appear in `ps aux`. When the FT module isn't loaded the hash still gets written; the sink logs the skip and exits 0.

When to reach for it

• Microsecond-latency keyword + vector search over peepshow runs, served from a Redis you already operate
• Pair with Redis Streams / Pub/Sub fan-out — same datastore, same operational footprint
• Embed peepshow into an existing Redis-backed agent memory layer without standing up a second search service

Install

npm i -g peepshow
# Redis 8+ with RediSearch module (preferred) or redis-stack
brew install redis  # or: https://redis.io/docs/latest/operate/oss_and_stack/install/

Use it

REDIS_URL="redis://127.0.0.1:6379" \
peepshow ./demo.mp4 --sink redis-vector

Make it automatic

Register the sink once — every run fires it afterward. Scope by --when so it only runs for matching videos.

peepshow sinks add redis-vector
peepshow sinks add redis-vector --when extension=mp4,mov
peepshow sinks add redis-vector --when path=/Volumes/Work/

Configuration

• REDIS_URL Redis connection URL. Default `redis://127.0.0.1:6379`.
• REDIS_INDEX FT index name + hash prefix. Default `peepshow:runs`.
• REDIS_PASSWORD Password sent via the `AUTH` command on stdin (kept out of argv).
• REDIS_BIN Override the `redis-cli` executable path. Default `redis-cli` (must be on PATH).
• PEEPSHOW_FRAME_BASE_URL When set, the first frame URL is written to the `thumbnail_url` hash field.

REDIS_URL="redis://127.0.0.1:6379" \
peepshow ./demo.mp4 --sink redis-vector

peepshow sinks add redis-vector
peepshow sinks add redis-vector --when extension=mp4,mov

Write your own

A sink is any executable that reads the --emit json payload on stdin. Shell, Node, Python, Go — the spec's in docs/PLUGINS.md. Register persistent ones with peepshow sinks add-cmd 'your-command'.