BerriAI/litellm · error · Exception

Vector store registry not found

Error message

Vector store registry not found

What it means

Guard in the Azure AI vector-store path: litellm.vector_store_registry is None because no vector stores were registered on the proxy (config/general settings), so the index name from the URL path cannot be resolved to a provider credential.

Source

Thrown at litellm/proxy/pass_through_endpoints/llm_passthrough_endpoints.py:1378

                content = await result.aread()
                return Response(
                    content=content,
                    status_code=result.status_code,
                    headers=HttpPassThroughEndpointHelpers.get_response_headers(
                        headers=result.headers,
                        custom_headers=None,
                    ),
                )
            elif is_vector_store_index:
                # get the api key from the provider config
                provider_config = ProviderConfigManager.get_provider_vector_stores_config(
                    provider=litellm.LlmProviders.AZURE_AI
                )
                if provider_config is None:
                    raise Exception("Provider config not found for Azure AI")
                # get the index from registry
                if litellm.vector_store_registry is None:
                    raise Exception("Vector store registry not found")

                is_allowed_to_call_vector_store_endpoint(
                    index_name=part,
                    provider=litellm.LlmProviders.AZURE_AI,
                    request=request,
                    user_api_key_dict=user_api_key_dict,
                )
                # get the vector store name from index registry
                index_object = (
                    (litellm.vector_store_index_registry.get_vector_store_index_by_name(vector_store_index_name=part))
                    if litellm.vector_store_index_registry is not None
                    else None
                )
                if index_object is None:
                    raise Exception(f"Vector store index not found for {part}")

                vector_store_name = index_object.litellm_params.vector_store_name

View on GitHub (pinned to 77b7c6c40c)

Solutions

  1. Configure a vector store registry (vector_stores in config.yaml) before using this route.
  2. Restart the proxy after adding the registry so it is initialized.
Defensive patterns

Strategy: type-guard

When it happens

Trigger: Thrown at litellm/proxy/pass_through_endpoints/llm_passthrough_endpoints.py:1378 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/ce68cd8fe5af44b2. Report an issue: GitHub.