Expand description
Unified configuration system for Hyprstream
This module provides a layered configuration architecture:
HyprConfig: Root configuration combining all subsystemsServerConfig: HTTP server configuration (network, CORS, TLS)- Model and runtime configs for ML inference
Re-exports§
pub use server::CorsConfig;pub use server::NinepCanonicalReadConfig;pub use server::SamplingParamDefaults;pub use server::ServerConfig;pub use server::ServerConfigBuilder;
Modules§
- server
- Server configuration with builder pattern
Structs§
- At9p
Renewal Config - In-daemon at9p service-identity renewal (
[registry.at9p_renewal]). - Claim
Mapping - Claim field name overrides for mapping a userinfo JSON response to standard claims.
- Credentials
Config - Credentials storage configuration.
- Discovery
Service Config - Discovery service configuration.
- Event
Service Config - Event proxy service configuration.
- Federate
Atproto Owner Enrollment - Trusted deployment mapping from one Federate ATProto owner identity to an already-enrolled local hosted account. Both values come from launcher or operator configuration; neither is accepted from callback parameters.
- Federate
Client Class Config - A second accepted Federate client class (W1: the client-side TUI harness).
- Flight
Config - /// Arrow Flight SQL server configuration
- Generation
Config - Text generation parameters
- Generation
Result - Generation result with metadata
- Hypr
Config - Unified configuration for the Hyprstream system
- Hypr
Config Builder - Builder for Hyprstream configuration
- Hyprstream
Training Config - Model-level training mode configuration (embedded in config.json under “hyprstream_training”)
- Inference
Server Config - Configuration for one deployable, CPU-only inference process.
- Lora
AppConfig - Application-level LoRA settings (TOML config: enabled, max_adapters, etc.)
- MCPConfig
- MCP service configuration (Model Context Protocol)
- MacBoot
Policy Config - Both independently provisioned artifacts and their expected policy pin are mandatory when configured. Keep this generation/hash pin in the OS-owned deployment configuration, outside the replaceable artifact directory. Deploy a new pin and matching artifacts as one release; a mismatch fails startup closed. Recovery restores the matching backed-up config and artifacts. Lowering the pin is an explicit rollback decision. Trust keys are never supplied by these files or this configuration.
- Mesh
Peer Config - Configuration for a trusted mesh peer’s post-quantum signing identity (#157).
- Metrics
Config - Metrics service configuration (DuckDB-backed time-series ingest + DataFusion query).
- Model
Config - Model loading and identification
- OAIConfig
- OpenAI-compatible HTTP API configuration
- OAuth
Config - OAuth 2.1 authorization server configuration
- Oidc
Provider Config - Configuration for an external OIDC provider (login delegation).
- Policy
Service Config - Policy service configuration.
- Quic
Config - RdsConfig
- Records/repository RDS (Multi-AZ Postgres) configuration.
- Registry
Service Config - Registry service configuration.
- Resolved
Sampling Params - Resolved sampling parameters with concrete values (no Options for required fields)
- RpcServer
Config - StreamService configuration
- Runtime
Config - Runtime execution configuration
- Sampling
Params - Unified sampling parameters with Option fields for clean precedence merging.
- Secrets
Config - Persistent secrets storage configuration.
- Services
Config - Service management configuration
- Storage
Config - Storage paths and directories configuration
- Streaming
Config - moq streaming plane configuration.
- TTTMetrics
- TTT adaptation metrics (mirrors training::ttt::TTTResult)
- TTTTraining
Config - TTT-specific configuration
- Templated
Prompt - A prompt string that has been processed through the chat template engine. This newtype prevents accidentally passing untemplated strings to generation.
- TlsConfig
- Token
Config - JWT token issuance configuration
- Trusted
Issuer Config - Configuration for a trusted external OIDC issuer.
- TuiService
Config - TUI display server configuration.
- Valkey
Credentials Config - Valkey connection settings (used when
backend = "valkey"). - XetConfig
- XetService configuration — HuggingFace-XET CAS HTTP face.
Enums§
- Credentials
Backend - Which backend stores account credentials.
- Finish
Reason - Why generation stopped
- Native
Network Profile - QUIC/WebTransport transport configuration.
- Provider
Kind - Protocol kind for an external OAuth/OIDC provider.
- Provisioning
Mode - Whether to auto-create users on first external login.
- TlsMode
- TLS configuration for HTTP services (OAI, OAuth, MCP).
- Training
Mode - Training mode configuration
- User
Mapping Strategy - How to map an external OIDC identity to a local hyprstream subject.
Constants§
- MAX_
SERVICE_ IDENTITY_ TTL_ SECS - Maximum accepted service-identity lifetime: 90 days. The at9p chain layer
has no maximum TTL of its own — this ceiling is provisioner-side policy.
90 days satisfies the anchor-TTL ≥ 3× worst-case-deploy-gap policy for the
30-day delegated-signer ceremony cadence, and the in-daemon renewal loop
(
services::at9p_renewal) renews at the half-TTL point so a live daemon never approaches it. - MIN_
SERVICE_ IDENTITY_ TTL_ SECS - Minimum accepted service-identity lifetime: shared by the offline
provisioner’s
--valid-for-secondsclamp and the in-daemon renewal TTL.
Functions§
- default_
lora_ rank - default_
target_ modules - explicit_
config_ path - The canonical explicit selector, if the operator supplied one.
- install_
explicit_ config_ path - Install the canonical explicit config selector provenance (write-once).
- install_
pinned_ config - Install the process-wide validated configuration snapshot (write-once).
- pinned_
config - The installed validated configuration snapshot, if startup pinned one.