{"record":{"id":"3b7c4c54922ba248","repo":"chroma-core/chroma","slug":"the-url-cannot-be-changed-after-the-embedding-func","errorCode":null,"errorMessage":"The URL cannot be changed after the embedding function has been initialized.","messagePattern":"The URL cannot be changed after the embedding function has been initialized\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"chromadb/utils/embedding_functions/huggingface_embedding_function.py","lineNumber":230,"sourceCode":"        return [\"cosine\", \"l2\", \"ip\"]\n\n    @staticmethod\n    def build_from_config(config: Dict[str, Any]) -> \"EmbeddingFunction[Documents]\":\n        url = config.get(\"url\")\n        api_key_env_var = config.get(\"api_key_env_var\")\n        if url is None:\n            raise ValueError(\"URL must be provided for HuggingFaceEmbeddingServer\")\n\n        return HuggingFaceEmbeddingServer(url=url, api_key_env_var=api_key_env_var)\n\n    def get_config(self) -> Dict[str, Any]:\n        return {\"url\": self.url, \"api_key_env_var\": self.api_key_env_var}\n\n    def validate_config_update(\n        self, old_config: Dict[str, Any], new_config: Dict[str, Any]\n    ) -> None:\n        if \"url\" in new_config and new_config[\"url\"] != self.url:\n            raise ValueError(\n                \"The URL cannot be changed after the embedding function has been initialized.\"\n            )\n\n    @staticmethod\n    def validate_config(config: Dict[str, Any]) -> None:\n        \"\"\"\n        Validate the configuration using the JSON schema.\n\n        Args:\n            config: Configuration to validate\n\n        Raises:\n            ValidationError: If the configuration does not match the schema\n        \"\"\"\n        validate_config_schema(config, \"huggingface_server\")\n","sourceCodeStart":212,"sourceCodeEnd":246,"githubUrl":"https://github.com/chroma-core/chroma/blob/aecdd12c8a891610db8653630b066b32ceb678b5/chromadb/utils/embedding_functions/huggingface_embedding_function.py#L212-L246","documentation":"Error \"The URL cannot be changed after the embedding function has been initialized.\" thrown in chroma-core/chroma.","triggerScenarios":"Thrown at chromadb/utils/embedding_functions/huggingface_embedding_function.py:230 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"aecdd12c8a891610db8653630b066b32ceb678b5","analyzedAt":"2026-08-16T21:53:27.228Z","schemaVersion":2},"datasetVersion":"2026-08-16T23:17:17.608Z"}