tinyhumansai/openhuman · error

model route with empty hint

Error message

model route with empty hint

What it means

Doctor warning from the model_routes loop: an [[model_routes]] entry exists whose `hint` field is empty or unset. The hint is the routing key that model selection uses to resolve a route, so an empty hint makes the entry unreachable — it silently matches nothing and any provider/model override it carries is dead config.

Source

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

            format!(
                "temperature {:.1} is out of range (expected 0.0-2.0)",
                config.default_temperature
            ),
        ));
    }

    // Reliability: fallback providers (legacy; ignored at runtime)
    if !config.reliability.fallback_providers.is_empty() {
        items.push(DiagnosticItem::warn(
            cat,
            "reliability.fallback_providers is set but ignored (single backend)",
        ));
    }

    // 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!(

View on GitHub (pinned to 7491200858)

Solutions

1. Set a unique non-empty `hint` on the [[model_routes]] entry in config.toml
2. Check for a typo such as `hits` or a misplaced table header that left hint unset
3. Remove the entry if it was left over from experimentation

When it happens

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