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 — seek · seek_text · seek_hybrid · explain_seekone process · no network hoplayer 3 · vaults (per memory class)vault: episodicturn embeddings + metavault: semanticentity cardsvault: corpusdocs · chunksvault: toolstrace embeddingslayer 4 · enginePlannerstrategy · filtersIndexPorthnsw · exact · gpuMetadataIndexequality setsEmbedderlocal · hostedGpuPortbatch · 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, fsync_on_checkpoint on ephemeral disks
  • Replicas: open with read_only=True 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_seek().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.