tinyhumansai/openhuman · error

embedding route "{}" uses invalid provider "{}": {}

Error message

embedding route "{}" uses invalid provider "{}": {}

What it means

Doctor diagnostic: an entry in config.embedding_routes names a provider that fails validation (unknown provider id or malformed value for its route.provider). The route is reported as a warning because an invalid embedding provider means embeddings for that hint will fail or fall back at runtime — e.g. memory ingestion and similarity search degrade.

Source

Thrown at src/openhuman/platform/doctor/core.rs:280

    for route in &config.model_routes {
        if route.hint.is_empty() {
            items.push(DiagnosticItem::warn(cat, "model route with empty hint"));
        }
        if route.model.is_empty() {
            items.push(DiagnosticItem::warn(
                cat,
                format!("model route \"{}\" has empty model", route.hint),
            ));
        }
    }

    // Embedding routes validation
    for route in &config.embedding_routes {
        if route.hint.trim().is_empty() {
            items.push(DiagnosticItem::warn(cat, "embedding route with empty hint"));
        }
        if let Some(reason) = embedding_provider_validation_error(&route.provider) {
            items.push(DiagnosticItem::warn(
                cat,
                format!(
                    "embedding route \"{}\" uses invalid provider \"{}\": {}",
                    route.hint, route.provider, reason
                ),
            ));
        }
        if route.model.trim().is_empty() {
            items.push(DiagnosticItem::warn(
                cat,
                format!("embedding route \"{}\" has empty model", route.hint),
            ));
        }
        if route.dimensions.is_some_and(|value| value == 0) {
            items.push(DiagnosticItem::warn(
                cat,
                format!(
                    "embedding route \"{}\" has invalid dimensions=0",

View on GitHub (pinned to 7491200858)

Solutions

  1. Run 'openhuman doctor' to list all embedding route warnings together
  2. Check config.toml [embedding_routes] entries — correct the provider field to a supported provider id (or remove the route to use the default)
  3. Run 'openhuman config get' (curated view) to inspect effective routes without exposing secrets
  4. Re-run doctor after the fix to confirm the warning clears
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at src/openhuman/platform/doctor/core.rs:280 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/a1d0a4e0a96316bd. Report an issue: GitHub.