How giggsoinc/aryx works
Aryx builds a persistent, provenance-aware context graph from enterprise data and serves that context to applications and AI agents. The main user journey is to connect sources, review discovered structure, build and resolve the graph, then query it through Ask, REST, or MCP. The graph preserves README-documented stages and capabilities; source excerpts additionally show API-to-orchestrator and orchestrator-to-stage wiring. Several feature implementations were not sampled, so those relationships rely on README evidence rather than inspected implementation details.
Main entry points: orchestrate.py Pipeline Orchestrator · postgres_store.py Postgres System · api Ingest APIs · discover.py Structure Discovery
Components 20
Connect and Ingest
- Ingest APIs
src/aryx/api - Source Connectors
src/aryx/connectors - Dataset Ingestion
src/aryx/dataset/ingest.py - Pipeline Orchestrator
src/aryx/pipeline/orchestrate.py
Discover and Resolve
- Structure Discovery
src/aryx/discover.py - Ontology Modeling
src/aryx/ontology - Entity Resolution
src/aryx/resolution - Human Review
src/aryx/api/adjudication_api.py
Graph and Governance
- Postgres System
src/aryx/store/postgres_store.py - Entity and Provenance Store
src/aryx/store/entity_store.py - Graph Retrieval
src/aryx/graph/retrieve.py - Graph Evolution
src/aryx/graph/changes.py
Agent Interfaces
- Grounded Ask
src/aryx/api/ask_api.py - REST APIs
src/aryx/api - MCP Tools
src/aryx/mcp
Web Experience
- Web UI
apps/web/app - Web API Client
apps/web/lib/api.ts
Other components
- Workspace User
- Enterprise Sources
- AI Agent
Connections 23
- Workspace User → Web UI: starts workspace
README.md - Web UI → Web API Client: requests services
- Enterprise Sources → Source Connectors: provides data
README.md - Workspace User → Ingest APIs: submits sources
README.md - Ingest APIs → Pipeline Orchestrator: starts ingestion
src/aryx/api/admin_api.py - Ingest APIs → Dataset Ingestion: registers datasets
src/aryx/api/file_ingest_api.py - Source Connectors → Structure Discovery: supplies records
src/aryx/pipeline/orchestrate.py - Pipeline Orchestrator → Structure Discovery: runs discovery
src/aryx/pipeline/orchestrate.py - Pipeline Orchestrator → Entity Resolution: runs resolution
src/aryx/pipeline/orchestrate.py - Structure Discovery → Ontology Modeling: proposes structure
README.md - Entity Resolution → Entity and Provenance Store: persists entities
src/aryx/store/entity_store.py - Workspace User → Human Review: reviews matches
README.md - Human Review → Entity Resolution: adjudicates identity
README.md - Pipeline Orchestrator → Entity and Provenance Store: writes graph entities
src/aryx/pipeline/orchestrate.py - Entity and Provenance Store → Postgres System: persists records
src/aryx/store/entity_store.py - Postgres System → Graph Retrieval: serves live graph
README.md - Pipeline Orchestrator → Graph Evolution: projects changes
src/aryx/pipeline/orchestrate.py - Graph Retrieval → Grounded Ask: grounds answers
README.md - Postgres System → REST APIs: backs APIs
README.md - Postgres System → MCP Tools: supplies context
README.md - Grounded Ask → AI Agent: returns cited answers
README.md - REST APIs → AI Agent: serves context
README.md - MCP Tools → AI Agent: exposes tools
README.md