About This Architecture
Elpis is a local-first Rust coding agent that combines an interactive shell interface with a control loop orchestrating filesystem access, shell execution, and LLM reasoning. The architecture routes developer commands through a Rust binary into a coding agent control loop, which delegates tasks to MCP tools for filesystem and shell operations while maintaining context via a memory system backed by vector embeddings. A local Ollama model server provides LLM inference without external dependencies, enabling offline-capable autonomous coding workflows. Fork this diagram to customize the MCP tool connectors, swap embedding models, or integrate alternative local LLM providers. The design demonstrates how to build privacy-preserving, self-contained development agents using Rust and open-source components.