tinyhumansai/openhuman · error

embedding route "{}" has invalid dimensions=0

Error message

embedding route "{}" has invalid dimensions=0

What it means

Doctor warning from the embedding_routes loop: the entry declares `dimensions = 0` (or omits a positive value). Embedding dimensions determine the vector size written to the memory store; a zero dimension cannot produce valid vectors, so any ingest or recall using this route will fail or be unusable.

Source

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

            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",
                    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

View on GitHub (pinned to 7491200858)

Solutions

1. Set `dimensions` to the model's true output size (e.g. 1536 for text-embedding-3-small, 3072 for -large, 768 for many bge models)
2. Look up the dimension in the embedding model's documentation rather than guessing — a wrong non-zero value corrupts similarity search
3. Changing dimensions on an existing store requires re-embedding accumulated chunks

When it happens

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