{"record":{"id":"974554882d513586","repo":"blakeblackshear/frigate","slug":"axengine-is-not-installed","errorCode":null,"errorMessage":"AXEngine is not installed.","messagePattern":"AXEngine is not installed\\.","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"critical","filePath":"frigate/detectors/plugins/axengine.py","lineNumber":42,"sourceCode":"\nclass AxengineDetectorConfig(BaseDetectorConfig):\n    \"\"\"AXERA AX650N/AX8850N NPU detector running compiled .axmodel files via the AXEngine runtime.\"\"\"\n\n    model_config = ConfigDict(\n        title=\"AXEngine NPU\",\n    )\n\n    type: Literal[DETECTOR_KEY]\n\n\nclass Axengine(DetectionApi):\n    type_key = DETECTOR_KEY\n\n    def __init__(self, config: AxengineDetectorConfig):\n        try:\n            import axengine as axe\n        except ModuleNotFoundError:\n            raise ImportError(\"AXEngine is not installed.\") from None\n\n        logger.info(\"__init__ axengine\")\n        super().__init__(config)\n        self.height = config.model.height\n        self.width = config.model.width\n        model_path = config.model.path or \"frigate-yolov9-tiny\"\n        model_props = self.parse_model_input(model_path)\n        self.session = axe.InferenceSession(model_props[\"path\"])\n\n    def __del__(self):\n        pass\n\n    def parse_model_input(self, model_path):\n        model_props = {}\n        model_props[\"preset\"] = True\n\n        model_matched = False\n","sourceCodeStart":24,"sourceCodeEnd":60,"githubUrl":"https://github.com/blakeblackshear/frigate/blob/ca18b8dc131ccb3e086f13a780853b775ef13426/frigate/detectors/plugins/axengine.py#L24-L60","documentation":"The axengine Python package (Axera AXEngine inference SDK) is not installed, so the Axengine detector plugin cannot initialize. This is a hard ImportError raised in __init__ immediately on plugin creation, meaning the deployment is on hardware/image without AXEngine support.","triggerScenarios":"Thrown at frigate/detectors/plugins/axengine.py:42 when the library encounters an invalid state.","commonSituations":"Running generic frigate docker on Axera hardware without the axengine layer; testing axengine config on x86 dev machines; SDK wheels installed for wrong python version so import fails.","solutions":["Use a Frigate build/image for Axera hardware that bundles the axengine SDK","Install the AXEngine SDK (axengine package plus its runtime dependencies) into the container/environment","If you are not on Axera hardware, switch the detector type to cpu/onnx or another supported backend"],"exampleFix":"# before\ndetectors:\n  axengine:\n    type: axengine\n# after (non-Axera hardware)\ndetectors:\n  cpu:\n    type: cpu","handlingStrategy":"validation","validationCode":"def axengine_available() -> bool:\n    try:\n        import axengine  # noqa: F401\n        return True\n    except ModuleNotFoundError:\n        return False","typeGuard":null,"tryCatchPattern":"try:\n    detector = AxengineDetector(config)\nexcept ImportError as e:\n    if 'AXEngine' in str(e):\n        raise SystemExit('AXEngine SDK missing: use the Axera Frigate build') from None\n    raise","preventionTips":["Use the Axera-specific Frigate build on Axera hardware","Probe for the SDK before configuring the axengine detector","Default to portable detectors on generic hardware"],"tags":["axengine","axera","import-error","module-not-found","detector"],"backgroundTag":"optional-dependency-not-installed","analyzedSha":"ca18b8dc131ccb3e086f13a780853b775ef13426","analyzedAt":"2026-08-27T11:28:05.618Z","schemaVersion":2},"datasetVersion":"2026-08-27T13:17:12.746Z"}