infiniflow/ragflow · error · LookupError

Instance {instance_name} not found for model {model_name}.

Error message

Instance {instance_name} not found for model {model_name}.

What it means

Error "Instance {instance_name} not found for model {model_name}." thrown in infiniflow/ragflow.

Source

Thrown at api/db/joint_services/tenant_model_service.py:237

    n = len(parts)
    if n == 3:
        pure_model_name, instance_name, provider_name = parts
    elif n == 2:
        pure_model_name, provider_name = parts
        instance_name = "default"
    else:
        pure_model_name = parts[0]
        provider_name = ""
        instance_name = ""
    return pure_model_name, instance_name, provider_name


def _resolve_instance_for_model(provider_obj, instance_name: str, model_name: str):
    instance_obj = TenantModelInstanceService.get_by_provider_id_and_instance_name(provider_obj.id, instance_name)
    if instance_obj:
        return instance_obj
    if instance_name != "default":
        raise LookupError(f"Instance {instance_name} not found for model {model_name}.")

    active_instances = [inst for inst in TenantModelInstanceService.get_all_by_provider_id(provider_obj.id) if inst.status == ActiveStatusEnum.ACTIVE.value]
    if len(active_instances) == 1:
        logger.warning(
            "Model instance fallback applied for legacy default instance name",
            extra={
                "provider_name": provider_obj.provider_name,
                "requested_instance_name": instance_name,
                "resolved_instance_name": active_instances[0].instance_name,
                "model_name": model_name,
            },
        )
        return active_instances[0]

    raise LookupError(f"Instance {instance_name} not found for model {model_name}.")


def resolve_model_config(tenant_id, model_type: str | enum.Enum, model_ref: str):

View on GitHub (pinned to 554fb1133a)

Solutions

1. Verify the provider instance name for the model is correct.
2. Check the tenant's configured model instances and use an existing one.

Example fix

# look up available instances first, then reference a valid instance_name

When it happens

Trigger: Thrown at api/db/joint_services/tenant_model_service.py:237 when the library encounters an invalid state.

Common situations: The model configuration references a provider instance that does not exist or was removed; using a valid instance name prevents this error.

AI-assisted analysis of infiniflow/ragflow@554fb1133a (2026-08-15). Data as JSON: /api/errors/b2914b6c3adb6543. Report an issue: GitHub.