tinyhumansai/openhuman · error

embedding route with empty hint

Error message

embedding route with empty hint

What it means

Doctor warning from the embedding_routes loop: an [[embedding_routes]] entry has an empty (or whitespace-only, since it is trimmed) `hint`. The hint is the key `hint:`-prefixed memory.embedding_model values resolve against, so the entry can never be selected and its provider/model settings are inert.

Source

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

    }

    // Model routes validation
    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(

View on GitHub (pinned to 7491200858)

Solutions

1. Give the [[embedding_routes]] entry a unique non-empty `hint` in config.toml
2. If memory.embedding_model references it via "hint:<name>", make the strings match exactly
3. Remove dead entries

When it happens

Trigger: Thrown at src/openhuman/platform/doctor/core.rs:277 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/1370f4a743f04672. Report an issue: GitHub.