elips/docs
Chapter XVI · production

Going to production

ELIPS is embedded — production is your binary, on a server, with disks you trust.

layer 1 · orchestrationAgent runtimeloop · tool routerTool registrysearch · code · fs · httpPolicy / guardquota · safetyTelemetryspans · evalslayer 2 · retrieval boundary (RAG bus)ElipsClient — search · search_text · hybrid_search · explain_queryone process · no network hoplayer 3 · collections (per memory class)collection: episodicturn embeddings + metacollection: semanticentity cardscollection: corpusdocs · chunkscollection: toolstrace embeddingslayer 4 · enginePlannerstrategy · filtersIndexhnsw · flat · gpuMetadataIndexequality setsEmbedderlocal · hostedGpuBackendbatch · streamlayer 5 · persistenceWAL (CRC32C)every mutationsegments/ (atomic rename)checkpointLOCK (flock)single writertext_embedder/rehydratableno daemons · no sidecars · agent owns the bytes
What the layered stack looks like when an agent runtime owns its own retrieval.
  • Durability: paranoid on durable storage, relaxed with scheduled checkpoints on ephemeral disks
  • Replicas: open with access_mode='read_only' from N readers; shared flock coordinates
  • Checkpoint: schedule elips checkpoint via cron/systemd-timer; tune cadence to recovery time
  • Backups: snapshot the directory while it is closed, or while only read-only openers hold it
  • Telemetry: emit explain().strategy and candidate_count per query
  • Compaction: run elips compact after large delete bursts to reclaim tombstones

You've now seen every concept in the engine. Each one has its own page in /docs and its own chapter here. The roadmap (docs/roadmap.md) is what is coming next.