Crate: vox-populi · Version: 0.6.0 · Target: Library (lib.rs)
Vox Populi: multi-node worker registry, HTTP control plane, and Mens native ML (Burn / Candle QLoRA).
Vox populi — node registry, optional HTTP control plane, and (feature mens) native ML.
CPU-first: each [NodeRecord] carries vox_orchestrator::TaskCapabilityHints. See
docs/src/architecture/populi-ssot.md for environment variables.
The mens module holds Burn/Candle QLoRA training (--features mens …).
| Feature | Default / Enables |
|---|
default | — |
gamify | dep:vox-gamify |
hw-probe-live-test | — |
inference | mens-candle-qlora |
mens | dep:anyhow, dep:serde_yaml, dep:ctrlc, dep:chrono, dep:dirs, dep:sysinfo, dep:rand, dep:vox-tensor, dep:vox-corpus, dep:vox-db, dep:vox-bounded-fs, dep:vox-hf-layout, dep:objc2-metal |
mens-candle-qlora | mens, dep:candle-core, dep:candle-nn, dep:safetensors, dep:tokenizers, dep:qlora-rs, dep:reqwest, dep:vox-quantize |
mens-candle-qlora-cuda | mens-candle-qlora, candle-core/cuda, candle-nn/cuda |
mens-candle-qlora-metal | mens-candle-qlora, candle-core/metal, candle-nn/metal |
mens-cloud | mens, mens-hf-hub, dep:reqwest, dep:vox-http-client, vox-db/host-integration |
mens-hf-hub | mens, dep:hf-hub, tokio/rt-multi-thread |
mens-train | mens, mens-candle-qlora, mens-hf-hub, dep:vox-eval, dep:vox-plugin-host |
mesh-discovery-publish | dep:vox-publisher |
nvml-gpu-probe | — |
tls | dep:rustls, dep:rustls-pemfile, dep:tokio-rustls |
transport | dep:axum, dep:reqwest, dep:reqwest-middleware, dep:vox-http-client, vox-http-client/middleware, dep:tower-http, dep:subtle, dep:vox-bounded-fs, dep:jsonwebtoken, dep:ed25519-dalek, dep:blake3, dep:data-encoding, dep:base64, dep:dashmap, dep:vox-db, dep:turso |
| Module | Description |
|---|
mens | — |
http_client | — |
http_lifecycle | — |
tls | — |
transport | — |
pairing | GitHub-attested pairing and revocation (P5-T2). |
quota | Per-key token-bucket quota + reputation EMA (P5-T3). |
distributed_training | — |
inference | MENS Mn-T2 inference backends (Candle CPU/CUDA/Metal, llama.cpp RPC, Ollama). |
| Struct | Description |
|---|
PopuliEnv | Parsed populi-related environment (best-effort). |
| Function | Description |
|---|
populi_enabled_from_env | Whether populi hooks are enabled (VOX_MESH_ENABLED=1 or true). |
populi_env_resolved | Merge Vox.toml [populi] into env-derived values when the corresponding env is unset. Precedence: environment always wins over TOML for each field. |
populi_advertise_gpu_effective | Whether VOX_MESH_ADVERTISE_GPU is set, or [populi].advertise_gpu = true when env is unset. |
normalize_http_control_base | Normalize a control-plane URL for use as an HTTP client base (join / heartbeat / list). Returns [None] for empty strings, invalid trim, or bind-all hosts (0.0.0.0, ::) where the value is meant for vox populi serve --bind, not outbound requests. |
populi_env | Read populi env vars (does not mutate process state). |
populi_scope_id_from_env | VOX_MESH_SCOPE_ID when set and non-empty after trim. |
wall_clock_unix_ms | Current Unix time in milliseconds (for federation timestamps and tests). |
resolve_vox_toml_best_effort | Resolve Vox.toml path next to the current working directory (nearest manifest root). |
node_record_for_current_process | Build a [NodeRecord] for this process using orchestrator host probe + populi env labels. |
publish_local_registry_best_effort | Register this process into the default local registry file (no-op if VOX_MESH_ENABLED is off). |
populi_registration_record_for_process | [NodeRecord] for this process — same id and listen_addr as [publish_local_registry_best_effort]. |
local_registry_path | Resolved on-disk registry path (honours VOX_MESH_REGISTRY_PATH). |
current_target_triple | Returns the current target triple (Wave 4 best-effort). |