{"record":{"id":"30c24e75e122c40f","repo":"assafelovic/gpt-researcher","slug":"embedding-provider-is-deprecated-and-will-be-remov","errorCode":null,"errorMessage":"EMBEDDING_PROVIDER is deprecated and will be removed soon. Use EMBEDDING instead.","messagePattern":"EMBEDDING_PROVIDER is deprecated and will be removed soon\\. Use EMBEDDING instead\\.","errorType":"console","errorClass":"FutureWarning","httpStatus":null,"severity":"warning","filePath":"gpt_researcher/config/config.py","lineNumber":102,"sourceCode":"            self.retrievers = [\"tavily\"]\n\n    def _set_embedding_attributes(self) -> None:\n        \"\"\"Parse and set embedding provider and model attributes.\"\"\"\n        self.embedding_provider, self.embedding_model = self.parse_embedding(\n            self.embedding\n        )\n\n    def _set_llm_attributes(self) -> None:\n        \"\"\"Parse and set LLM provider and model attributes for all LLM types.\"\"\"\n        self.fast_llm_provider, self.fast_llm_model = self.parse_llm(self.fast_llm)\n        self.smart_llm_provider, self.smart_llm_model = self.parse_llm(self.smart_llm)\n        self.strategic_llm_provider, self.strategic_llm_model = self.parse_llm(self.strategic_llm)\n        self.reasoning_effort = self.parse_reasoning_effort(os.getenv(\"REASONING_EFFORT\"))\n\n    def _handle_deprecated_attributes(self) -> None:\n        \"\"\"Handle deprecated configuration attributes with warnings.\"\"\"\n        if os.getenv(\"EMBEDDING_PROVIDER\") is not None:\n            warnings.warn(\n                \"EMBEDDING_PROVIDER is deprecated and will be removed soon. Use EMBEDDING instead.\",\n                FutureWarning,\n                stacklevel=2,\n            )\n            self.embedding_provider = (\n                os.environ[\"EMBEDDING_PROVIDER\"] or self.embedding_provider\n            )\n\n            embedding_provider = os.environ[\"EMBEDDING_PROVIDER\"]\n            if embedding_provider == \"ollama\":\n                self.embedding_model = os.environ[\"OLLAMA_EMBEDDING_MODEL\"]\n            elif embedding_provider == \"custom\":\n                self.embedding_model = os.getenv(\"OPENAI_EMBEDDING_MODEL\", \"custom\")\n            elif embedding_provider == \"openai\":\n                self.embedding_model = \"text-embedding-3-large\"\n            elif embedding_provider == \"azure_openai\":\n                self.embedding_model = \"text-embedding-3-large\"\n            elif embedding_provider == \"huggingface\":","sourceCodeStart":84,"sourceCodeEnd":120,"githubUrl":"https://github.com/assafelovic/gpt-researcher/blob/6f998577d547b1e54ec662dac63583aa11e3b84b/gpt_researcher/config/config.py#L84-L120","documentation":"A FutureWarning (not an exception) emitted by Config when the EMBEDDING_PROVIDER environment variable is set: that variable is deprecated in favor of EMBEDDING. The value is still honored for backward compatibility, so nothing breaks yet, but support will be removed.","triggerScenarios":"Instantiating Config (i.e. creating GPTResearcher or the agent backend) with EMBEDDING_PROVIDER defined in the environment or .env file.","commonSituations":"Upgrading gpt-researcher while keeping old .env files or docker-compose/Dockerfile ENV entries from earlier versions; tutorials that predate the rename.","solutions":["Replace EMBEDDING_PROVIDER=... with EMBEDDING=... in your environment/.env.","Search the repo for 'EMBEDDING_PROVIDER' (docker-compose, CI secrets, deploy scripts) and update all occurrences.","If tests assert no warnings, filter FutureWarning or pin the config in test fixtures."],"exampleFix":"# before\nEMBEDDING_PROVIDER=ollama\n# after\nEMBEDDING=ollama","handlingStrategy":"validation","validationCode":"import os\nassert \"EMBEDDING_PROVIDER\" not in os.environ, \"rename EMBEDDING_PROVIDER to EMBEDDING\"","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Keep .env files in sync with the current config reference after upgrades.","Run startup checks that assert deprecated env vars are absent.","Treat FutureWarnings as migration TODOs, not noise."],"tags":["deprecation","configuration","python"],"backgroundTag":"deprecated-env-var","analyzedSha":"6f998577d547b1e54ec662dac63583aa11e3b84b","analyzedAt":"2026-08-28T17:50:07.383Z","schemaVersion":2},"datasetVersion":"2026-08-28T21:17:43.275Z"}