tinyhumansai/openhuman · error

memory.embedding_model uses hint "{hint}" but no matching [[

Error message

memory.embedding_model uses hint "{hint}" but no matching [[embedding_routes]] entry exists

What it means

Doctor cross-check between config keys: memory.embedding_model is set to "hint:<name>", but no [[embedding_routes]] entry carries a matching hint (comparison is trimmed). At runtime the hint resolves to nothing, so the memory subsystem cannot find its embedding provider and either errors or silently skips embedding ingest/recall.

Source

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

                    route.hint
                ),
            ));
        }
    }

    if let Some(hint) = config
        .memory
        .embedding_model
        .strip_prefix("hint:")
        .map(str::trim)
        .filter(|value| !value.is_empty())
    {
        if !config
            .embedding_routes
            .iter()
            .any(|route| route.hint.trim() == hint)
        {
            items.push(DiagnosticItem::warn(
                cat,
                format!(
                    "memory.embedding_model uses hint \"{hint}\" but no matching [[embedding_routes]] entry exists"
                ),
            ));
        }
    }

    // Channel: at least one configured
    let cc = &config.channels_config;
    let has_channel = cc.telegram.is_some()
        || cc.discord.is_some()
        || cc.slack.is_some()
        || cc.imessage.is_some()
        || cc.matrix.is_some()
        || cc.whatsapp.is_some()
        || cc.email.is_some()
        || cc.irc.is_some()

View on GitHub (pinned to 7491200858)

Solutions

1. Fix the typo: make the string after "hint:" exactly equal to an existing [[embedding_routes]] entry's `hint`
2. Or add the missing [[embedding_routes]] entry with that hint, a valid provider, model and dimensions
3. Alternatively replace the hint: form with an explicit provider/model pair if no route indirection is wanted

When it happens

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