{"record":{"id":"b5d97181c648a44c","repo":"odysseus-dev/odysseus","slug":"model-cache-path-must-not-be-a-symlink","errorCode":null,"errorMessage":"Model cache path must not be a symlink","messagePattern":"Model cache path must not be a symlink","errorType":"http","errorClass":"HTTPException","httpStatus":400,"severity":"error","filePath":"routes/embedding_routes.py","lineNumber":236,"sourceCode":"            raise HTTPException(400, \"Model is currently downloading\")\n\n        try:\n            from fastembed import TextEmbedding\n        except ImportError:\n            raise HTTPException(503, \"fastembed is not installed\")\n\n        catalog = {m[\"model\"]: m for m in TextEmbedding.list_supported_models()}\n        if model_name not in catalog:\n            raise HTTPException(404, f\"Unknown model: {model_name}\")\n\n        hf_src = catalog[model_name].get(\"sources\", {}).get(\"hf\", \"\")\n        if not hf_src:\n            raise HTTPException(400, \"No cache source for this model\")\n\n        try:\n            model_path = _model_cache_path(hf_src)\n        except ValueError as e:\n            raise HTTPException(400, str(e))\n        if not model_path.is_dir():\n            return {\"deleted\": False, \"message\": \"Model not cached\"}\n\n        shutil.rmtree(model_path)\n        logger.info(f\"Deleted cached model: {model_name} ({model_path})\")\n        return {\"deleted\": True, \"model\": model_name}\n\n    @router.get(\"/endpoint\")\n    def get_endpoint():\n        \"\"\"Get the current custom embedding endpoint config.\"\"\"\n        saved = _load_custom_endpoint()\n        current_url = os.environ.get(\"EMBEDDING_URL\", \"\")\n        return {\n            \"url\": saved.get(\"url\", current_url),\n            \"model\": saved.get(\"model\", os.environ.get(\"EMBEDDING_MODEL\", \"\")),\n            \"active\": bool(saved.get(\"url\") or current_url),\n        }\n","sourceCodeStart":218,"sourceCodeEnd":254,"githubUrl":"https://github.com/odysseus-dev/odysseus/blob/f9235ebbf13f693a6fd29ce70b097f6ec83705bf/routes/embedding_routes.py#L218-L254","documentation":"Error \"Model cache path must not be a symlink\" thrown in odysseus-dev/odysseus.","triggerScenarios":"Triggered when the corresponding server-side validation or runtime check at the recorded location rejects the request or operation and returns this error message to the caller.","commonSituations":"See trigger scenarios.","solutions":["Remove the symlink and use the real cache directory path.","Do not link the model cache to locations outside the cache root."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"f9235ebbf13f693a6fd29ce70b097f6ec83705bf","analyzedAt":"2026-08-14T21:47:48.359Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}