Myria Docs

This directory contains two kinds of documentation:

• short guides for people trying to understand or operate Myria
• one full specification in design.md

Recommended Reading Order

1. Quick Start
2. Configuration
3. Architecture
4. Data Model
5. Indexing and Querying
6. MCP API
7. Storage
8. Operations
9. Full Design Specification

Guide Map

• Quick Start Minimal working local setup for running Myria.

• Configuration Full configuration reference, including stdio MCP, PostgreSQL, builder, and OpenRouter settings.

• Architecture Explains the service boundary, runtime shape, and major subsystems.

• Data Model Explains events, participants, topics, snapshots, nodes, IDs, and visibility rules.

• Indexing and Querying Explains append flow, build triggers, fresh-tail retrieval, deterministic paths, and LLM-controlled workflows.

• MCP API Explains the public stdio MCP tool surface, including conversation tools and admin/observability tools.

• Storage Explains the PostgreSQL tables, keys, and how snapshots and node membership are persisted.

• Operations Explains configuration, local development, testing, OpenRouter integration, and operational expectations.

• design.md The full end-to-end design specification.