BerriAI/litellm · error · ImportError

Could not find a module loader for {module_file_path}

Error message

Could not find a module loader for {module_file_path}

What it means

The module spec was created but its loader attribute is None, so importlib has no mechanism to actually execute the file. Rare; indicates an exotic or corrupted module file at the path derived from the config file's directory.

Source

Thrown at litellm/proxy/types_utils/utils.py:49

        # Split the path by dots to separate module from instance
        parts: Final = value.split(".")

        # The module path is all but the last part, and the instance_name is the last part
        module_name = ".".join(parts[:-1])
        instance_name = parts[-1]

        module_file_path = None
        if config_file_path is not None:
            directory: Final = os.path.dirname(config_file_path)
            module_file_path = os.path.join(directory, *module_name.split(".")) + ".py"

        if module_file_path is not None and os.path.exists(module_file_path):
            spec: Final = importlib.util.spec_from_file_location(module_name, module_file_path)
            if spec is None:
                raise ImportError(f"Could not find a module specification for {module_file_path}")
            module = importlib.util.module_from_spec(spec)
            if spec.loader is None:
                raise ImportError(f"Could not find a module loader for {module_file_path}")
            spec.loader.exec_module(module)
        else:
            module = importlib.import_module(module_name)

        # Get the instance from the module
        instance: Final = getattr(module, instance_name)

        return instance
    except ImportError as e:
        # Re-raise the exception with a user-friendly message
        if instance_name and module_name:
            raise ImportError(f"Could not import {instance_name} from {module_name}") from e
        else:
            raise e
    except Exception as e:
        raise e

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Ensure the file is a loadable Python module (valid .py file) and the path is correct.

When it happens

Trigger: Thrown at litellm/proxy/types_utils/utils.py:49 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/d13df2f8097df74e. Report an issue: GitHub.