init_redis_indexes

Create the RediSearch indexes used across Stargazer v3.

ensure_indexes creates eight indexes: the message HNSW vector index plus the tool/skill/dangerous-command/benign-tech centroid vector indexes and the observability, debug-observability, and LLM-request event-log indexes.

Run standalone:

python init_redis_indexes.py [--redis-url redis://localhost:6379/0]

Or import and call during bot startup:

from init_redis_indexes import ensure_indexes
await ensure_indexes(redis_client)

Requires the RediSearch module to be loaded on the Redis server (e.g. FalkorDB image, Redis Stack, or redis-server --loadmodule redisearch.so).

Note: The knowledge-graph indexes (entities/relationships) are managed by knowledge_graph.KnowledgeGraphManager via FalkorDB Cypher CREATE VECTOR INDEX commands, not by this module.

async init_redis_indexes.ensure_indexes(r)[source]

Ensure all eight Stargazer RediSearch indexes exist.

Creates the message vector index plus the tool, skill, dangerous-command, benign-tech, observability, debug-observability, and LLM-request indexes.

Returns a dict mapping index name to whether it was freshly created.

Note: Knowledge-graph vector indexes are managed by knowledge_graph.KnowledgeGraphManager via FalkorDB Cypher.

Return type:: dict[str, bool]
Parameters:: r (redis.asyncio.Redis)