{"record":{"id":"ef02c9487c23fe86","repo":"huggingface/transformers","slug":"locallayerrepository-requires-kernels-to-be-inst","errorCode":null,"errorMessage":"LocalLayerRepository requires `kernels` to be installed. Run `pip install kernels`.","messagePattern":"LocalLayerRepository requires `kernels` to be installed\\. Run `pip install kernels`\\.","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"src/transformers/integrations/hub_kernels.py","lineNumber":554,"sourceCode":"\n        return decorator\n\n    def use_kernel_func_from_hub(*args, **kwargs):\n        def decorator(cls):\n            return cls\n\n        return decorator\n\n    class LayerRepository:\n        def __init__(self, *args, **kwargs):\n            raise RuntimeError(\"LayerRepository requires `kernels` to be installed. Run `pip install kernels`.\")\n\n        def load(self):\n            raise NotImplementedError(\"LayerRepository requires `kernels` to be installed. Run `pip install kernels.\")\n\n    class LocalLayerRepository:\n        def __init__(self, *args, **kwargs):\n            raise RuntimeError(\"LocalLayerRepository requires `kernels` to be installed. Run `pip install kernels`.\")\n\n        def load(self):\n            raise NotImplementedError(\n                \"LocalLayerRepository requires `kernels` to be installed. Run `pip install kernels.\"\n            )\n\n    class FuncRepository:\n        def __init__(self, *args, **kwargs):\n            raise RuntimeError(\"FuncRepository requires `kernels` to be installed. Run `pip install kernels`.\")\n\n    def replace_kernel_forward_from_hub(*args, **kwargs):\n        raise RuntimeError(\n            \"replace_kernel_forward_from_hub requires `kernels` to be installed. Run `pip install kernels`.\"\n        )\n\n    def register_kernel_mapping(*args, **kwargs):\n        raise RuntimeError(\"register_kernel_mapping requires `kernels` to be installed. Run `pip install kernels`.\")\n","sourceCodeStart":536,"sourceCodeEnd":572,"githubUrl":"https://github.com/huggingface/transformers/blob/a597f974857b3d92939971296bc0deb93d33d780/src/transformers/integrations/hub_kernels.py#L536-L572","documentation":"`LocalLayerRepository` is the stub replacement for the `kernels` package's class that loads kernels from a local directory instead of the Hub. In environments without `kernels`, its `__init__` raises RuntimeError immediately with the install instruction, mirroring the `LayerRepository` stub.","triggerScenarios":"Constructing `LocalLayerRepository(...)` (e.g. `use_local_kernel` flows where a model config points at local kernel directories) while `kernels` is not installed.","commonSituations":"Offline/air-gapped deployments that deliberately use local kernels but where the `kernels` package was omitted from the environment; sharing configs with `use_local_kernel=True` across machines.","solutions":["Install `kernels` (`pip install kernels`) even for local kernel use — the local loader lives in that package.","Set `kernel_config.use_local_kernel = False` / avoid local-kernel configs if you cannot install it.","Gate the code path on `is_kernels_available()`."],"exampleFix":"# before\nrepo = LocalLayerRepository(\"/path/to/kernels\")  # RuntimeError\n\n# after\nfrom transformers.utils.import_utils import is_kernels_available\nassert is_kernels_available(), \"pip install kernels\"\nrepo = LocalLayerRepository(\"/path/to/kernels\")","handlingStrategy":"type-guard","validationCode":"from transformers.utils.import_utils import is_kernels_available\nassert is_kernels_available(), \"local kernels still require the kernels package\",\nrepo = LocalLayerRepository(\"/path/to/kernels\")","typeGuard":"def can_use_local_kernels() -> bool:\n    from transformers.utils.import_utils import is_kernels_available\n    return is_kernels_available()","tryCatchPattern":"try:\n    repo = LocalLayerRepository(path)\nexcept RuntimeError as e:\n    if \"kernels\" in str(e):\n        repo = LayerRepository(hub_repo_id) if is_kernels_available() else None\n    else:\n        raise","preventionTips":["Include the kernels package in offline/air-gapped images — local loading still needs it.","Make configs with use_local_kernel conditional on environment capability."],"tags":["dependencies","kernels","local-kernels","offline"],"backgroundTag":null,"analyzedSha":"a597f974857b3d92939971296bc0deb93d33d780","analyzedAt":"2026-08-14T18:24:08.354Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}