From 54fd27a0477b3233bdde3904fa18ddc36530e986 Mon Sep 17 00:00:00 2001
From: Ivan Despot <66276597+g-despot@users.noreply.github.com>
Date: Fri, 26 Jun 2026 23:06:53 +0200
Subject: [PATCH 1/3] docs: add generative-deepseek model provider integration
page
Document the new generative-deepseek module (DeepSeek as a generative/RAG
provider), available from v1.36.19, v1.37.10, and v1.38.2.
- New provider pages model-providers/deepseek/{index,generative}.md (Python only for now)
- Document the X-Deepseek-Api-Key and X-Deepseek-Baseurl headers and the
DEEPSEEK_APIKEY env var
- Config keys (model, temperature, maxTokens, frequencyPenalty,
presencePenalty, topP, baseURL, stop) with defaults
- Recommend deepseek-v4-flash / deepseek-v4-pro; note deepseek-chat and
deepseek-reasoner are legacy aliases (deprecated 2026-07-24 per DeepSeek)
- Add DeepSeek to the model-providers table and sidebar
- Python snippets show the intended Configure.Generative.deepseek(...) syntax
(client support to follow); kept out of the CI snippet allowlist
---
.../_includes/provider.connect.py | 8 +
.../_includes/provider.generative.py | 104 +++++++++
.../model-providers/deepseek/generative.md | 200 ++++++++++++++++++
.../model-providers/deepseek/index.md | 42 ++++
docs/weaviate/model-providers/index.md | 1 +
sidebars.js | 10 +
6 files changed, 365 insertions(+)
create mode 100644 docs/weaviate/model-providers/deepseek/generative.md
create mode 100644 docs/weaviate/model-providers/deepseek/index.md
diff --git a/docs/weaviate/model-providers/_includes/provider.connect.py b/docs/weaviate/model-providers/_includes/provider.connect.py
index 022ba957..1a656009 100644
--- a/docs/weaviate/model-providers/_includes/provider.connect.py
+++ b/docs/weaviate/model-providers/_includes/provider.connect.py
@@ -33,6 +33,10 @@
# Recommended: save sensitive data as environment variables
databricks_token = os.getenv("DATABRICKS_TOKEN")
# END DatabricksInstantiation
+# START DeepseekInstantiation
+# Recommended: save sensitive data as environment variables
+deepseek_key = os.getenv("DEEPSEEK_APIKEY")
+# END DeepseekInstantiation
# START DigitalOceanInstantiation
# Recommended: save sensitive data as environment variables
digitalocean_key = os.getenv("DIGITALOCEAN_APIKEY")
@@ -114,6 +118,10 @@
# START DatabricksInstantiation
"X-Databricks-Token": databricks_token,
# END DatabricksInstantiation
+# START DeepseekInstantiation
+ "X-Deepseek-Api-Key": deepseek_key,
+ # "X-Deepseek-Baseurl": "https://api.deepseek.com", # Optional; for providing a custom base URL
+# END DeepseekInstantiation
# START DigitalOceanInstantiation
"X-Digitalocean-Api-Key": digitalocean_key,
# END DigitalOceanInstantiation
diff --git a/docs/weaviate/model-providers/_includes/provider.generative.py b/docs/weaviate/model-providers/_includes/provider.generative.py
index f4f82051..6e0092d6 100644
--- a/docs/weaviate/model-providers/_includes/provider.generative.py
+++ b/docs/weaviate/model-providers/_includes/provider.generative.py
@@ -857,6 +857,110 @@ def import_data():
# clean up
client.collections.delete("DemoCollection")
+# ---------------------------------------------------------------------------
+# DeepSeek generative integration (generative-deepseek).
+#
+# These snippets are documented AHEAD of Python client support:
+# `Configure.Generative.deepseek()` and `GenerativeConfig.deepseek()` do not
+# yet exist in the released weaviate-client (pinned in pyproject.toml). The
+# blocks below are DISPLAY-ONLY — they are rendered in the docs via
+# FilteredTextBlock (with `language="pyindent"`, which strips the 4-space guard
+# indent) and are intentionally kept out of the test runner's allowlist in
+# tests/test_python.py. The `if DEEPSEEK_CLIENT_AVAILABLE:` guard is a
+# belt-and-suspenders measure so that even if this file is ever executed
+# end-to-end, the not-yet-released `deepseek()` calls can never run.
+# TODO: set DEEPSEEK_CLIENT_AVAILABLE = True and drop `pyindent` once the
+# weaviate-client ships Configure.Generative.deepseek() / GenerativeConfig.deepseek().
+# ---------------------------------------------------------------------------
+DEEPSEEK_CLIENT_AVAILABLE = False
+
+if DEEPSEEK_CLIENT_AVAILABLE:
+ # START BasicGenerativeDeepseek
+ from weaviate.classes.config import Configure
+
+ client.collections.create(
+ "DemoCollection",
+ # highlight-start
+ generative_config=Configure.Generative.deepseek()
+ # highlight-end
+ # Additional parameters not shown
+ )
+ # END BasicGenerativeDeepseek
+
+ # clean up
+ client.collections.delete("DemoCollection")
+
+ # START GenerativeDeepseekCustomModel
+ from weaviate.classes.config import Configure
+
+ client.collections.create(
+ "DemoCollection",
+ # highlight-start
+ generative_config=Configure.Generative.deepseek(
+ model="deepseek-v4-flash"
+ )
+ # highlight-end
+ # Additional parameters not shown
+ )
+ # END GenerativeDeepseekCustomModel
+
+ # clean up
+ client.collections.delete("DemoCollection")
+
+ # START FullGenerativeDeepseek
+ from weaviate.classes.config import Configure
+
+ client.collections.create(
+ "DemoCollection",
+ # highlight-start
+ generative_config=Configure.Generative.deepseek(
+ # # These parameters are optional
+ # model="deepseek-v4-flash",
+ # temperature=0.7,
+ # max_tokens=500,
+ # frequency_penalty=0.0,
+ # presence_penalty=0.0,
+ # top_p=1.0,
+ # base_url="https://api.deepseek.com",
+ # stop=["\n\n"],
+ )
+ # highlight-end
+ )
+ # END FullGenerativeDeepseek
+
+ # clean up
+ client.collections.delete("DemoCollection")
+ import_data()
+
+ # START RuntimeModelSelectionDeepseek
+ from weaviate.classes.config import Configure
+ from weaviate.classes.generate import GenerativeConfig
+
+ collection = client.collections.use("DemoCollection")
+ response = collection.generate.near_text(
+ query="A holiday film",
+ limit=2,
+ grouped_task="Write a tweet promoting these two movies",
+ # highlight-start
+ generative_provider=GenerativeConfig.deepseek(
+ # # These parameters are optional
+ # model="deepseek-v4-flash",
+ # temperature=0.7,
+ # max_tokens=500,
+ # frequency_penalty=0.0,
+ # presence_penalty=0.0,
+ # top_p=1.0,
+ # base_url="https://api.deepseek.com",
+ # stop=["\n\n"],
+ ),
+ # Additional parameters not shown
+ # highlight-end
+ )
+ # END RuntimeModelSelectionDeepseek
+
+ # clean up
+ client.collections.delete("DemoCollection")
+
# START BasicGenerativeNVIDIA
from weaviate.classes.config import Configure
diff --git a/docs/weaviate/model-providers/deepseek/generative.md b/docs/weaviate/model-providers/deepseek/generative.md
new file mode 100644
index 00000000..5a3c0bee
--- /dev/null
+++ b/docs/weaviate/model-providers/deepseek/generative.md
@@ -0,0 +1,200 @@
+---
+title: Generative AI
+description: "Weaviate's integration with DeepSeek's API allows you to access their generative models' capabilities directly from Weaviate."
+sidebar_position: 50
+image: og/docs/model-provider-integrations.jpg
+# tags: ['model providers', 'deepseek', 'generative', 'rag']
+---
+
+# DeepSeek Generative AI with Weaviate
+
+import FilteredTextBlock from '@site/src/components/Documentation/FilteredTextBlock';
+import PyConnect from '!!raw-loader!../_includes/provider.connect.py';
+import PyCode from '!!raw-loader!../_includes/provider.generative.py';
+
+Weaviate's integration with DeepSeek's API allows you to access their generative models' capabilities directly from Weaviate.
+
+[Configure a Weaviate collection](#configure-collection) to use a generative AI model with DeepSeek. Weaviate will perform retrieval augmented generation (RAG) using the specified model and your DeepSeek API key.
+
+More specifically, Weaviate will perform a search, retrieve the most relevant objects, and then pass them to the DeepSeek generative model to generate outputs.
+
+:::info Code examples are Python-only for now
+This page currently shows Python examples only. The typed builder syntax shown below (`Configure.Generative.deepseek()`) is the intended Python client API; client support is being implemented to match it. Other client languages will be added once the corresponding client support ships.
+:::
+
+## Requirements
+
+### Weaviate configuration
+
+Your Weaviate instance must be configured with the DeepSeek generative AI integration (`generative-deepseek`) module.
+
+:::info Added in `v1.36.19`, `v1.37.10`, and `v1.38.2`
+The `generative-deepseek` module was added as a coordinated backport across the `v1.36`, `v1.37`, and `v1.38` release lines. It is available from `v1.36.19` (on the `v1.36` line), `v1.37.10` (on the `v1.37` line), and `v1.38.2` (on the `v1.38` line). Earlier patch releases on these lines do not include the module.
+:::
+
+
+ For Weaviate Cloud (WCD) users
+
+This integration is enabled by default on Weaviate Cloud (WCD) instances.
+
+
+
+
+ For self-hosted users
+
+- Check the [cluster metadata](/deploy/configuration/status.md#cluster-metadata) to verify if the module is enabled.
+- Follow the [how-to configure modules](../../configuration/modules.md) guide to enable the module in Weaviate.
+- To enable the module, include it in the `ENABLE_MODULES` environment variable available to Weaviate, e.g. `ENABLE_MODULES="generative-deepseek"` (add it to your existing comma-separated list if other modules are enabled).
+
+
+
+### API credentials
+
+You must provide a valid DeepSeek API key to Weaviate for this integration. Go to [DeepSeek](https://platform.deepseek.com/) to sign up and obtain an API key.
+
+Provide the API key to Weaviate using one of the following methods:
+
+- Set the `DEEPSEEK_APIKEY` environment variable that is available to Weaviate.
+- Provide the API key at runtime, as shown in the examples below.
+
+
+
+## Configure collection
+
+import MutableGenerativeConfig from '/_includes/mutable-generative-config.md';
+
+
+
+[Configure a Weaviate index](../../manage-collections/generative-reranker-models.mdx#specify-a-generative-model-integration) as follows to use a DeepSeek generative model:
+
+
+
+### Select a model
+
+You can specify one of the [available models](#available-models) for Weaviate to use, as shown in the following configuration example:
+
+
+
+You can [specify](#generative-parameters) one of the [available models](#available-models) for Weaviate to use. The [default model](#available-models) is used if no model is specified.
+
+### Generative parameters
+
+Configure the following generative parameters to customize the model behavior.
+
+
+
+For further details on model parameters, see the [DeepSeek API documentation](https://api-docs.deepseek.com/).
+
+## Select a model at runtime
+
+Aside from setting the default model provider when creating the collection, you can also override it at query time.
+
+
+
+## Header parameters
+
+You can provide the API key as well as some optional parameters at runtime through additional headers in the request. The following headers are available:
+
+- `X-Deepseek-Api-Key`: The DeepSeek API key.
+- `X-Deepseek-Baseurl`: The base URL to use (e.g. a proxy) instead of the default DeepSeek URL.
+
+These headers are case-insensitive on the wire. Any additional headers provided at runtime will override the existing Weaviate configuration.
+
+Provide the headers as shown in the [API credentials examples](#api-credentials) above.
+
+## Retrieval augmented generation
+
+After configuring the generative AI integration, perform RAG operations, either with the [single prompt](#single-prompt) or [grouped task](#grouped-task) method.
+
+### Single prompt
+
+To generate text for each object in the search results, use the single prompt method.
+
+The example below generates outputs for each of the `n` search results, where `n` is specified by the `limit` parameter.
+
+When creating a single prompt query, use braces `{}` to interpolate the object properties you want Weaviate to pass on to the language model. For example, to pass on the object's `title` property, include `{title}` in the query.
+
+
+
+### Grouped task
+
+To generate one text for the entire set of search results, use the grouped task method.
+
+In other words, when you have `n` search results, the generative model generates one output for the entire group.
+
+
+
+## References
+
+### Available models
+
+Weaviate forwards the configured model name to DeepSeek as-is; there is no allowlist on the Weaviate side, so any current DeepSeek model id is accepted. We recommend setting `model` explicitly to one of the current models:
+
+* `deepseek-v4-flash` (recommended; verified with this integration)
+* `deepseek-v4-pro`
+
+The module's built-in default model is `deepseek-chat`.
+
+:::caution Legacy model aliases scheduled for deprecation
+According to [DeepSeek's pricing page](https://api-docs.deepseek.com/quick_start/pricing), `deepseek-chat` and `deepseek-reasoner` are legacy aliases scheduled for deprecation on **2026-07-24**, and they currently map to `deepseek-v4-flash` (in non-thinking and thinking modes, respectively). To avoid disruption, set `model` explicitly to a current `deepseek-v4-*` model id rather than relying on the default.
+:::
+
+:::note Reasoning output is not returned
+The `generative-deepseek` module returns only the model's message content. If you use a reasoning/thinking model, the separate reasoning (chain-of-thought) output is not surfaced through the integration.
+:::
+
+For the full list of models and pricing, see the [DeepSeek pricing page](https://api-docs.deepseek.com/quick_start/pricing) and the [DeepSeek API documentation](https://api-docs.deepseek.com/).
+
+## Further resources
+
+### Code examples
+
+Once the integration is configured at the collection, the data management and search operations in Weaviate work identically to any other collection. See the following model-agnostic examples:
+
+- The [How-to: Manage collections](../../manage-collections/index.mdx) and [How-to: Manage objects](../../manage-objects/index.mdx) guides show how to perform data operations (i.e. create, read, update, delete collections and objects within them).
+- The [How-to: Query & Search](../../search/index.mdx) guides show how to perform search operations (i.e. vector, keyword, hybrid) as well as retrieval augmented generation.
+
+### References
+
+- [DeepSeek API documentation](https://api-docs.deepseek.com/)
+
+## Questions and feedback
+
+import DocsFeedback from '/_includes/docs-feedback.mdx';
+
+
diff --git a/docs/weaviate/model-providers/deepseek/index.md b/docs/weaviate/model-providers/deepseek/index.md
new file mode 100644
index 00000000..62707257
--- /dev/null
+++ b/docs/weaviate/model-providers/deepseek/index.md
@@ -0,0 +1,42 @@
+---
+title: DeepSeek + Weaviate
+sidebar_position: 10
+image: og/docs/model-provider-integrations.jpg
+# tags: ['model providers', 'deepseek']
+---
+
+
+
+DeepSeek offers a range of models for natural language processing and generation. Weaviate seamlessly integrates with the DeepSeek API, allowing users to leverage DeepSeek's generative models directly from the Weaviate Database.
+
+This integration empowers developers to build sophisticated AI-driven applications with ease.
+
+## Integrations with DeepSeek
+
+### Generative AI models for RAG
+
+DeepSeek's generative AI models can generate human-like text based on given prompts and contexts.
+
+[Weaviate's generative AI integration](./generative.md) enables users to perform retrieval augmented generation (RAG) directly from the Weaviate Database. This combines Weaviate's efficient storage and fast retrieval capabilities with DeepSeek's generative AI models to generate personalized and context-aware responses.
+
+[DeepSeek generative AI integration page](./generative.md)
+
+## Summary
+
+This integration enables developers to leverage DeepSeek's generative models directly within Weaviate.
+
+In turn, it simplifies the process of building AI-driven applications to speed up your development process, so that you can focus on creating innovative solutions.
+
+## Get started
+
+You must provide a valid DeepSeek API key to Weaviate for this integration. Go to [DeepSeek](https://platform.deepseek.com/) to sign up and obtain an API key.
+
+Then, go to the relevant integration page to learn how to configure Weaviate with the DeepSeek models and start using them in your applications.
+
+- [Generative AI](./generative.md)
+
+## Questions and feedback
+
+import DocsFeedback from '/_includes/docs-feedback.mdx';
+
+
diff --git a/docs/weaviate/model-providers/index.md b/docs/weaviate/model-providers/index.md
index d6c85263..f41e4360 100644
--- a/docs/weaviate/model-providers/index.md
+++ b/docs/weaviate/model-providers/index.md
@@ -24,6 +24,7 @@ This enables an enhanced developed experience, such as the ability to:
| [Cohere](./cohere/index.md) | [Text](./cohere/embeddings.md), [Multimodal](./cohere/embeddings-multimodal.md) | [Text](./cohere/generative.md) | [Reranker](./cohere/reranker.md) |
| [Contextual AI](./contextualai/index.md) | - | [Text](./contextualai/generative.md) | [Reranker](./contextualai/reranker.md) |
| [Databricks](./databricks/index.md) | [Text](./databricks/embeddings.md) | [Text](./databricks/generative.md) | - |
+| [DeepSeek](./deepseek/index.md) | - | [Text](./deepseek/generative.md) | - |
| [DigitalOcean](./digitalocean/index.md) | [Text](./digitalocean/embeddings.md) | - | - |
| [FriendliAI](./friendliai/index.md) | - | [Text](./friendliai/generative.md) | - |
| [Google](./google/index.md) | [Text](./google/embeddings.md), [Multimodal](./google/embeddings-multimodal.md) | [Text](./google/generative.md) | - |
diff --git a/sidebars.js b/sidebars.js
index 2e07fe83..b4414870 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -238,6 +238,16 @@ const sidebars = {
"weaviate/model-providers/databricks/generative",
],
},
+ {
+ type: "category",
+ label: "DeepSeek",
+ className: "sidebar-item",
+ link: {
+ type: "doc",
+ id: "weaviate/model-providers/deepseek/index",
+ },
+ items: ["weaviate/model-providers/deepseek/generative"],
+ },
{
type: "category",
label: "DigitalOcean",
From 9f271a91999451089ff338962356a138202f21e8 Mon Sep 17 00:00:00 2001
From: Ivan Despot <66276597+g-despot@users.noreply.github.com>
Date: Thu, 30 Jul 2026 13:59:22 +0200
Subject: [PATCH 2/3] docs: correct generative-deepseek model, header and
timeout guidance
The page shipped with a deprecation notice written as a future event
(2026-07-24). That date has passed, so state it as settled fact:
deepseek-chat and deepseek-reasoner are retired and DeepSeek no longer
serves them.
Core still ships DefaultDeepSeekModel = "deepseek-chat"
(modules/generative-deepseek/config/class_settings.go:33, still true on
v1.38.7), so the page's basic no-model example resolved to a retired
alias. Present setting `model` as required rather than as an optional
refinement: drop the no-model example, lead "Configure collection" with
the warning and then the model-setting example, and disclose the
built-in default as a caution instead of a neutral fact. Name only the
current model names and link DeepSeek's pricing page rather than
maintaining a catalogue.
Correct "Header parameters", which was wrong. X-Deepseek-Api-Key does
not override collection config (there is no API key there); it overrides
the DEEPSEEK_APIKEY env var, and with neither set the request fails with
"api key: no api key found" (clients/deepseek.go:240-248).
X-Deepseek-Baseurl outranks the query-time baseURL param as well as the
collection baseURL (clients/deepseek.go:75, 232-238). Also note that the
base URL must be an API root, since Weaviate appends /chat/completions
to it.
Add two traps that were missing. MODULES_CLIENT_TIMEOUT defaults to 50s
and covers the whole request including the body read
(usecases/config/environment.go:869-876); the module's own acceptance
test raises it to 120s, so reasoning models need a note. And the
maxTokens ceiling is only consulted for the two retired aliases, so for
a current model a value above the model's limit passes validation and
only fails later as an error from DeepSeek; negative values are still
rejected for every model by the unconditional arm of the same check
(class_settings.go:89).
Fold the reasoning caveats into one "Reasoning models" subsection rather
than stacking admonitions, and link MODULES_CLIENT_TIMEOUT by its
APITable row anchor.
Update the Python snippet guard comment: Configure.Generative.deepseek()
and GenerativeConfig.deepseek() are merged upstream (PR #2084, commit
afc0e0eb) and signature-matched, but are not in a released client, so
the blocks stay display-only and out of the test allowlist.
Ignore platform.deepseek.com in the link validator; it 403s automated
requests but loads fine in a browser, matching existing entries.
---
_build_scripts/link-validator.js | 1 +
.../_includes/provider.generative.py | 41 ++++++++---------
.../model-providers/deepseek/generative.md | 46 +++++++++----------
.../model-providers/deepseek/index.md | 1 +
4 files changed, 43 insertions(+), 46 deletions(-)
diff --git a/_build_scripts/link-validator.js b/_build_scripts/link-validator.js
index 2b3c8715..eacdddac 100644
--- a/_build_scripts/link-validator.js
+++ b/_build_scripts/link-validator.js
@@ -45,6 +45,7 @@ const domainsToIgnore = [
'medium.com', // TODO[g-despot]: started throwing Forbidden 403 (incl. subdomains, e.g. *.medium.com)
'https://www.npmjs.com',
'https://openai.com',
+ 'https://platform.deepseek.com', // 403s automated requests (site loads fine in a browser)
'https://platform.openai.com',
'https://www.researchgate.net',
'https://simple/',
diff --git a/docs/weaviate/model-providers/_includes/provider.generative.py b/docs/weaviate/model-providers/_includes/provider.generative.py
index 6e0092d6..6d413960 100644
--- a/docs/weaviate/model-providers/_includes/provider.generative.py
+++ b/docs/weaviate/model-providers/_includes/provider.generative.py
@@ -860,35 +860,32 @@ def import_data():
# ---------------------------------------------------------------------------
# DeepSeek generative integration (generative-deepseek).
#
-# These snippets are documented AHEAD of Python client support:
-# `Configure.Generative.deepseek()` and `GenerativeConfig.deepseek()` do not
-# yet exist in the released weaviate-client (pinned in pyproject.toml). The
-# blocks below are DISPLAY-ONLY — they are rendered in the docs via
+# `Configure.Generative.deepseek()` and `GenerativeConfig.deepseek()` are
+# merged upstream on the Python client's main branch (PR #2084, commit
+# afc0e0eb, 2026-06-28), and the calls below match those signatures exactly
+# (keyword-only: base_url, model, temperature, max_tokens, frequency_penalty,
+# presence_penalty, top_p, stop). They are not in a released client yet: the
+# newest tag is v4.22.0 (2026-06-18), which predates that commit, and this
+# repo pins weaviate-client==4.22.0 in pyproject.toml.
+#
+# So the blocks below stay DISPLAY-ONLY: they are rendered in the docs via
# FilteredTextBlock (with `language="pyindent"`, which strips the 4-space guard
# indent) and are intentionally kept out of the test runner's allowlist in
# tests/test_python.py. The `if DEEPSEEK_CLIENT_AVAILABLE:` guard is a
# belt-and-suspenders measure so that even if this file is ever executed
-# end-to-end, the not-yet-released `deepseek()` calls can never run.
-# TODO: set DEEPSEEK_CLIENT_AVAILABLE = True and drop `pyindent` once the
-# weaviate-client ships Configure.Generative.deepseek() / GenerativeConfig.deepseek().
+# end-to-end, the `deepseek()` calls the pinned client lacks can never run.
+# TODO: once pyproject.toml pins a weaviate-client release that contains
+# afc0e0eb, set DEEPSEEK_CLIENT_AVAILABLE = True, unindent these blocks and
+# switch their FilteredTextBlock `language` from `pyindent` back to `py`, and
+# add this file to the allowlist in tests/test_python.py.
# ---------------------------------------------------------------------------
DEEPSEEK_CLIENT_AVAILABLE = False
if DEEPSEEK_CLIENT_AVAILABLE:
- # START BasicGenerativeDeepseek
- from weaviate.classes.config import Configure
-
- client.collections.create(
- "DemoCollection",
- # highlight-start
- generative_config=Configure.Generative.deepseek()
- # highlight-end
- # Additional parameters not shown
- )
- # END BasicGenerativeDeepseek
-
- # clean up
- client.collections.delete("DemoCollection")
+ # NOTE: there is deliberately no "basic" no-model block for DeepSeek. The
+ # module's built-in default model is the retired `deepseek-chat` alias, so
+ # `Configure.Generative.deepseek()` with no arguments is not a usable
+ # example. Every documented DeepSeek block sets `model` explicitly.
# START GenerativeDeepseekCustomModel
from weaviate.classes.config import Configure
@@ -914,8 +911,8 @@ def import_data():
"DemoCollection",
# highlight-start
generative_config=Configure.Generative.deepseek(
+ model="deepseek-v4-flash",
# # These parameters are optional
- # model="deepseek-v4-flash",
# temperature=0.7,
# max_tokens=500,
# frequency_penalty=0.0,
diff --git a/docs/weaviate/model-providers/deepseek/generative.md b/docs/weaviate/model-providers/deepseek/generative.md
index 5a3c0bee..519bece9 100644
--- a/docs/weaviate/model-providers/deepseek/generative.md
+++ b/docs/weaviate/model-providers/deepseek/generative.md
@@ -19,7 +19,7 @@ Weaviate's integration with DeepSeek's API allows you to access their generative
More specifically, Weaviate will perform a search, retrieve the most relevant objects, and then pass them to the DeepSeek generative model to generate outputs.
:::info Code examples are Python-only for now
-This page currently shows Python examples only. The typed builder syntax shown below (`Configure.Generative.deepseek()`) is the intended Python client API; client support is being implemented to match it. Other client languages will be added once the corresponding client support ships.
+Examples for the other client languages will follow.
:::
## Requirements
@@ -29,7 +29,7 @@ This page currently shows Python examples only. The typed builder syntax shown b
Your Weaviate instance must be configured with the DeepSeek generative AI integration (`generative-deepseek`) module.
:::info Added in `v1.36.19`, `v1.37.10`, and `v1.38.2`
-The `generative-deepseek` module was added as a coordinated backport across the `v1.36`, `v1.37`, and `v1.38` release lines. It is available from `v1.36.19` (on the `v1.36` line), `v1.37.10` (on the `v1.37` line), and `v1.38.2` (on the `v1.38` line). Earlier patch releases on these lines do not include the module.
+The `generative-deepseek` module is available from `v1.36.19` on the `v1.36` line, `v1.37.10` on the `v1.37` line, and `v1.38.2` on the `v1.38` line. Earlier patch releases on these lines do not include it.
:::
@@ -70,27 +70,22 @@ import MutableGenerativeConfig from '/_includes/mutable-generative-config.md';
+Always set `model` explicitly. The module's built-in default is a retired model alias, so a collection configured without a `model` points at a model that DeepSeek no longer serves. See [Available models](#available-models) for the current model names.
+
[Configure a Weaviate index](../../manage-collections/generative-reranker-models.mdx#specify-a-generative-model-integration) as follows to use a DeepSeek generative model:
### Select a model
-You can specify one of the [available models](#available-models) for Weaviate to use, as shown in the following configuration example:
-
-
+Specify any current DeepSeek model name. See [Available models](#available-models) for the current names, and [Generative parameters](#generative-parameters) for the other settings you can configure alongside it.
-You can [specify](#generative-parameters) one of the [available models](#available-models) for Weaviate to use. The [default model](#available-models) is used if no model is specified.
+You can also [override the model at query time](#select-a-model-at-runtime).
### Generative parameters
@@ -103,6 +98,8 @@ Configure the following generative parameters to customize the model behavior.
language="pyindent"
/>
+Weaviate checks `maxTokens` against a built-in ceiling only for the retired `deepseek-chat` and `deepseek-reasoner` aliases. For any current model, a `maxTokens` above the model's limit is accepted when you create the collection and fails later, as an error from DeepSeek at query time.
+
For further details on model parameters, see the [DeepSeek API documentation](https://api-docs.deepseek.com/).
## Select a model at runtime
@@ -123,7 +120,9 @@ You can provide the API key as well as some optional parameters at runtime throu
- `X-Deepseek-Api-Key`: The DeepSeek API key.
- `X-Deepseek-Baseurl`: The base URL to use (e.g. a proxy) instead of the default DeepSeek URL.
-These headers are case-insensitive on the wire. Any additional headers provided at runtime will override the existing Weaviate configuration.
+`X-Deepseek-Api-Key` takes precedence over the `DEEPSEEK_APIKEY` environment variable. The API key is never part of the collection configuration, so if neither the header nor the environment variable is set, the request fails with `api key: no api key found`.
+
+`X-Deepseek-Baseurl` takes precedence over a `baseURL` set at query time, which in turn takes precedence over the `baseURL` in the collection configuration. If none of them are set, Weaviate uses `https://api.deepseek.com`. Provide an API root rather than a full endpoint path, because Weaviate appends `/chat/completions` to it.
Provide the headers as shown in the [API credentials examples](#api-credentials) above.
@@ -163,22 +162,21 @@ In other words, when you have `n` search results, the generative model generates
### Available models
-Weaviate forwards the configured model name to DeepSeek as-is; there is no allowlist on the Weaviate side, so any current DeepSeek model id is accepted. We recommend setting `model` explicitly to one of the current models:
+Weaviate forwards the configured model name to DeepSeek as-is. There is no allowlist on the Weaviate side, so any current DeepSeek model name is accepted.
-* `deepseek-v4-flash` (recommended; verified with this integration)
-* `deepseek-v4-pro`
+The current model names are `deepseek-v4-flash` and `deepseek-v4-pro`. For the full list of models and pricing, see the [DeepSeek pricing page](https://api-docs.deepseek.com/quick_start/pricing) and the [DeepSeek API documentation](https://api-docs.deepseek.com/).
-The module's built-in default model is `deepseek-chat`.
+:::caution The module default is a retired model
+The `deepseek-chat` and `deepseek-reasoner` aliases are retired and DeepSeek no longer serves them. They previously pointed at `deepseek-v4-flash` in its non-thinking and thinking modes respectively.
-:::caution Legacy model aliases scheduled for deprecation
-According to [DeepSeek's pricing page](https://api-docs.deepseek.com/quick_start/pricing), `deepseek-chat` and `deepseek-reasoner` are legacy aliases scheduled for deprecation on **2026-07-24**, and they currently map to `deepseek-v4-flash` (in non-thinking and thinking modes, respectively). To avoid disruption, set `model` explicitly to a current `deepseek-v4-*` model id rather than relying on the default.
+The built-in default model of the `generative-deepseek` module is still `deepseek-chat`, so a collection created without a `model` points at a retired alias. Set `model` on every collection you create.
:::
-:::note Reasoning output is not returned
-The `generative-deepseek` module returns only the model's message content. If you use a reasoning/thinking model, the separate reasoning (chain-of-thought) output is not surfaced through the integration.
-:::
+### Reasoning models
+
+The `generative-deepseek` module returns only the model's message content. If you use a reasoning model, its separate reasoning (chain-of-thought) output is not surfaced through the integration.
-For the full list of models and pricing, see the [DeepSeek pricing page](https://api-docs.deepseek.com/quick_start/pricing) and the [DeepSeek API documentation](https://api-docs.deepseek.com/).
+Reasoning models can take much longer to respond than non-reasoning models. Weaviate applies the [`MODULES_CLIENT_TIMEOUT`](/deploy/configuration/env-vars/index.md#MODULES_CLIENT_TIMEOUT) environment variable to the whole request, including reading the response, and it defaults to 50 seconds. If reasoning queries time out, raise this value on your Weaviate instance.
## Further resources
diff --git a/docs/weaviate/model-providers/deepseek/index.md b/docs/weaviate/model-providers/deepseek/index.md
index 62707257..b009ac18 100644
--- a/docs/weaviate/model-providers/deepseek/index.md
+++ b/docs/weaviate/model-providers/deepseek/index.md
@@ -1,5 +1,6 @@
---
title: DeepSeek + Weaviate
+description: "DeepSeek offers a range of models for natural language processing and generation. Weaviate seamlessly integrates with the DeepSeek API, allowing users to leverage DeepSeek's generative models directly from the Weaviate Database."
sidebar_position: 10
image: og/docs/model-provider-integrations.jpg
# tags: ['model providers', 'deepseek']
From 009adc0800bc47d8dc1237dc7ead1611b3fae869 Mon Sep 17 00:00:00 2001
From: Ivan Despot <66276597+g-despot@users.noreply.github.com>
Date: Thu, 30 Jul 2026 14:55:34 +0200
Subject: [PATCH 3/3] docs: add DeepSeek RAG integration illustrations
---
.../_includes/integration_deepseek_rag.png | Bin 0 -> 231949 bytes
.../integration_deepseek_rag_grouped.png | Bin 0 -> 231682 bytes
.../integration_deepseek_rag_single.png | Bin 0 -> 232461 bytes
.../model-providers/deepseek/generative.md | 6 ++++++
.../weaviate/model-providers/deepseek/index.md | 2 ++
5 files changed, 8 insertions(+)
create mode 100644 docs/weaviate/model-providers/_includes/integration_deepseek_rag.png
create mode 100644 docs/weaviate/model-providers/_includes/integration_deepseek_rag_grouped.png
create mode 100644 docs/weaviate/model-providers/_includes/integration_deepseek_rag_single.png
diff --git a/docs/weaviate/model-providers/_includes/integration_deepseek_rag.png b/docs/weaviate/model-providers/_includes/integration_deepseek_rag.png
new file mode 100644
index 0000000000000000000000000000000000000000..81825f35c9dcea233f1d3480b30d64d9d4bc9e61
GIT binary patch
literal 231949
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