How czxieddan/ariadnion works
Ariadnion is a modular Rust service gateway and operations platform: a request enters through optional HTTP interfaces, is routed to a provider, and returns a result. The core supplies module lifecycle, capability, identity, and health contracts; optional crates provide API protocols, routing, provider integrations, accounts, identity, and persistence. The README documents independent assembly and the complete distribution model, but sampled excerpts do not show the bundle wiring or most optional runtime calls. Dashed links indicate those unverified connections.
Main entry points: public.rs HTTP endpoints · engine.rs Routing coordinator · lifecycle.rs Module lifecycle · lib.rs OpenAI protocol
Components 17
Core runtime
- Core contracts
crates/ariadnion-core/src/lib.rs - Module lifecycle
crates/ariadnion-core/src/lifecycle.rs - Capability registry
crates/ariadnion-core/src/capability.rs - Request context
crates/ariadnion-core/src/context.rs
API surface
- HTTP endpoints
crates/optional/ariadnion-api-http/src/public.rs - OpenAI protocol
crates/optional/ariadnion-protocol-openai/src/lib.rs - API contracts
crates/optional/ariadnion-api-domain/src/lib.rs - Stream bridge
crates/optional/ariadnion-api-stream/src/bridge.rs
Routing and providers
- Routing coordinator
crates/optional/ariadnion-routing-coordinator/src/engine.rs - Provider dispatch
crates/optional/ariadnion-provider-dispatch/src/dispatch.rs - HTTP provider
crates/optional/ariadnion-provider-http/src/connector.rs
Platform services
- Account services
crates/optional/ariadnion-account-domain/src/lib.rs - Identity and auth
crates/optional/ariadnion-auth-session/src/repository.rs - File operations
crates/optional/ariadnion-file-service/src/pipe.rs - Embedded storage
crates/optional/ariadnion-storage-rnmdb/src/query.rs
Other components
- API caller
- Model provider
Connections 14
- API caller → HTTP endpoints: sends request
- HTTP endpoints → OpenAI protocol: decodes request
- HTTP endpoints → API contracts: uses contracts
- HTTP endpoints → Routing coordinator: submits request
- Routing coordinator → Provider dispatch: selects provider
- Provider dispatch → HTTP provider: invokes provider
- HTTP provider → Model provider: sends request
- Routing coordinator → Account services: evaluates accounts
- OpenAI protocol → Stream bridge: encodes streams
- Module lifecycle → Capability registry: validates capabilities
crates/ariadnion-core/src/lifecycle.rs - Module lifecycle → Core contracts: uses contracts
crates/ariadnion-core/src/lifecycle.rs - HTTP endpoints → Request context: uses context
- Identity and auth → Embedded storage: persists identity
- File operations → Embedded storage: uses storage