{"record":{"id":"5f3232792f1aa93a","repo":"BerriAI/litellm","slug":"unsupported-url-scheme-in-remote-url","errorCode":null,"errorMessage":"Unsupported URL scheme in {remote_url}","messagePattern":"Unsupported URL scheme in (.+?)","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"litellm/proxy/types_utils/utils.py","lineNumber":94,"sourceCode":"    Args:\n        remote_url (str): The s3:// or gcs:// URL\n        config_file_path (str): Optional config file path for temp directory context\n\n    Returns:\n        Any: The loaded instance\n    \"\"\"\n    try:\n        from litellm._logging import verbose_proxy_logger\n\n        # Parse the URL\n        if remote_url.startswith(\"s3://\"):\n            storage_type = \"s3\"\n            url_without_prefix = remote_url[5:]  # Remove 's3://'\n        elif remote_url.startswith(\"gcs://\"):\n            storage_type = \"gcs\"\n            url_without_prefix = remote_url[6:]  # Remove 'gcs://'\n        else:\n            raise ValueError(f\"Unsupported URL scheme in {remote_url}\")\n\n        # Split bucket and path\n        parts: Final = url_without_prefix.split(\"/\", 1)\n        if len(parts) < 2:\n            raise ValueError(\n                f\"Invalid URL format: {remote_url}. Expected: {storage_type}://bucket-name/path/to/module.instance\"\n            )\n\n        bucket_name: Final = parts[0]\n        path_and_module: Final = parts[1]\n\n        # Extract module path and instance name\n        # Example: \"loggers/custom_callbacks.proxy_handler_instance\"\n        # Handle case where user accidentally includes .py extension\n        if path_and_module.endswith(\".py\"):\n            module_name_without_py: Final = path_and_module[:-3]  # Remove .py\n            raise ValueError(\n                f\"Invalid URL format in {remote_url}. \"","sourceCodeStart":76,"sourceCodeEnd":112,"githubUrl":"https://github.com/BerriAI/litellm/blob/77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8/litellm/proxy/types_utils/utils.py#L76-L112","documentation":"URL-scheme dispatch in _load_instance_from_remote_storage: the value carried a config_file_path (so remote loading is allowed) but its scheme is neither s3:// nor gcs://. Only those two object-storage schemes are supported for remote module loading.","triggerScenarios":"Thrown at litellm/proxy/types_utils/utils.py:94 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a supported URL scheme (s3:// or gcs://) for the remote module URL."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8","analyzedAt":"2026-08-18T11:44:31.656Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}