chore!: drop Python 3.10 support by julian-risch · Pull Request #4105 · deepset-ai/haystack-core-integrations

julian-risch · 2026-10-15T07:16:49Z

Related Issues

None. Follow-up to chore!: drop Python 3.10 support, add Python 3.15 haystack#13054. haystack-ai 3.4.0 requires Python >=3.11.

Proposed Changes:

Python 3.10 reaches end of life in October 2026. This PR drops it from all integrations, as the chore!: PRs in January 2026 did for 3.9:

Package metadata: requires-python = ">=3.11", and the Python :: 3.10 classifier is removed. This applies to the 104 integrations that still allowed 3.10 and to scripts/utils/templates/pyproject.toml.
Ruff autofixes: ruff now targets 3.11, and I ran ruff check --fix and ruff format in every integration (the same as hatch run fmt). The fixes it made:
- datetime.UTC instead of timezone.utc (UP017)
- Self and NotRequired from typing instead of typing_extensions (UP035)
- TimeoutError instead of asyncio.TimeoutError (UP041)
- firecrawl and watsonx: the unused timezone import is removed by hand, since F401 is unfixable in their config.
Public (str, Enum) classes keep their base, marked # noqa: UP042:
- ExportType in docling and docling_serve, ConversionMode in docling_serve, Command in github, TruncationDirection in huggingface_api, RankerTruncateMode in nvidia.
- With StrEnum, str() and f-strings would render the value instead of ExportType.MARKDOWN. That user-visible change doesn't belong in this PR. haystack kept ChatRole the same way.
3.10-only workarounds removed:
- mcp: the exceptiongroup backport dependency and its imports. The builtin ExceptionGroup is the same class on 3.11+.
- cognee: the litellm<1.97.0; python_version < '3.11' cap and its comment.
- sqlalchemy: the pandas 2 entry for python_version < '3.11'. It is now just pandas>=3.0.0.
Stale ruff target-version settings removed (py310 in deepeval, mcp, valkey and watsonx; py39 in llama_stack). Ruff now infers the target from requires-python.

How did you test it?

ruff check and ruff format --check pass in all 107 integrations.

Locally on Python 3.11, hatch run test:types and hatch run test:unit pass for 16 of the 20 integrations whose source changed, plus cognee and sqlalchemy for their dependency changes:

Integration	Unit tests passed
amazon_bedrock	266
anthropic	147
azure_ai_search	97
docling_serve	52
firecrawl	33
github	118
google_genai	161
gotenberg	72
huggingface_api	228
ibm_db	141
libreoffice	29
mcp	113
nvidia	187
parallel	34
perplexity	90
watsonx	51
cognee	37
sqlalchemy	15

docling, transformers, llama_cpp and vllm (torch, llama.cpp or vLLM builds) are covered by this PR's CI only.

Notes for the reviewer

test: use Python 3.11 in tests instead of 3.10 #4103 (merged) moved CI to Python 3.11. This PR changes only package metadata and code, no workflows.
The ! makes git-cliff mark this commit as breaking in every integration's changelog. As with the 3.9 drop, each integration's next release should be a major version.

Checklist

I have read the contributors guidelines and the code of conduct
I have updated the related issue with new insights and changes — n/a, no related issue
I added unit tests and updated the docstrings — n/a, no behavior change
I've used one of the conventional commit types for my PR title: fix:, feat:, build:, chore:, ci:, docs:, style:, refactor:, perf:, test:.

🤖 Generated with Claude Code

haystack-ai main (3.5.0rc0) and the upcoming 3.4.0 require Python >=3.11, so the nightly "run unit tests with Haystack main branch" step fails on every 3.10 leg. Move the minimum tested version to 3.11 in all workflows and the workflow template. llama_stack's push default and coverage gates use 3.12, its minimum version. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

… tests numpy 1.22 has no cp311 wheels, so the lowest-direct job on Python 3.11 built it from source and faiss-cpu 1.8.0 failed to import with "module compiled against API version 0x10 but this version of numpy is 0xf". numpy 1.23.2 is the first release with cp311 wheels. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Python 3.10 reaches end of life in October 2026, and haystack-ai 3.4.0 requires Python >=3.11. Set requires-python to >=3.11 and remove the 3.10 classifier in every integration and in the pyproject template. - Ruff now targets 3.11, so `hatch run fmt` applied its autofixes: `datetime.UTC` instead of `timezone.utc`, `Self`/`NotRequired` from `typing`, and `TimeoutError` instead of `asyncio.TimeoutError`. - Public `(str, Enum)` classes keep their base and get `# noqa: UP042`: `StrEnum` would change their `str()` output. - Remove backports that only applied to 3.10: mcp's `exceptiongroup` dependency, cognee's litellm cap and sqlalchemy's pandas 2 marker. - Remove stale ruff `target-version` settings, so ruff infers the target from `requires-python`. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

github-actions · 2026-10-15T10:28:33Z

Coverage report (solr)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:37Z

Coverage report (huggingface_api)

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
integrations/huggingface_api/src/haystack_integrations/components/generators/huggingface_api/chat
chat_generator.py
integrations/huggingface_api/src/haystack_integrations/components/rankers/huggingface_api
ranker.py
Project Total

_{This report was generated by python-coverage-comment-action}

github-actions · 2026-10-15T10:28:38Z

Coverage report (anthropic)

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
integrations/anthropic/src/haystack_integrations/components/generators/anthropic/chat
chat_generator.py
Project Total

_{This report was generated by python-coverage-comment-action}

github-actions · 2026-10-15T10:28:43Z

Coverage report (oracle)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:45Z

Coverage report (ragas)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:49Z

Coverage report (funasr)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:52Z

Coverage report (valkey)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:53Z

Coverage report (elasticsearch)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:55Z

Coverage report (whisper)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:55Z

Coverage report (azure_doc_intelligence)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:56Z

Coverage report (supabase)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:28:57Z

Coverage report (hanlp)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:29:12Z

Coverage report (opensearch)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:29:20Z

Coverage report (spacy)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:29:21Z

Coverage report (vespa)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:29:29Z

Coverage report (optimum)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:29:48Z

Coverage report (sentence_transformers)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:29:50Z

Coverage report (ollama)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:29:50Z

Coverage report (docling)

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
integrations/docling/src/haystack_integrations/components/converters/docling
converter.py
Project Total

_{This report was generated by python-coverage-comment-action}

github-actions · 2026-10-15T10:29:52Z

Coverage report (transformers)

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
integrations/transformers/src/haystack_integrations/components/generators/transformers/chat
chat_generator.py					514-517
Project Total

_{This report was generated by python-coverage-comment-action}

github-actions · 2026-10-15T10:30:00Z

Coverage report (ibm_db)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:30:06Z

Coverage report (llama_stack)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:30:14Z

Coverage report (llama_cpp)

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
integrations/llama_cpp/src/haystack_integrations/components/generators/llama_cpp/chat
chat_generator.py
Project Total

_{This report was generated by python-coverage-comment-action}

github-actions · 2026-10-15T10:30:31Z

Coverage report (chonkie)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:31:14Z

Coverage report (azure_documentdb)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:31:55Z

Coverage report (vllm)

This PR does not seem to contain any modification to coverable code.

github-actions · 2026-10-15T10:36:20Z

Coverage report (unstructured)

This PR does not seem to contain any modification to coverable code.

julian-risch · 2026-10-15T11:03:59Z

@sjrl Regarding the six failures: hetzner is fixed on main now. The other five are quota/API key issues. Not related to this PR.

julian-risch and others added 3 commits October 15, 2026 09:06

sjrl approved these changes Oct 16, 2026

View reviewed changes

julian-risch mentioned this pull request Oct 16, 2026

chore!: otari - drop Python 3.10 and test with Python 3.15 #4117

Merged

Conversation

julian-risch commented Oct 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related Issues

Proposed Changes:

How did you test it?

Notes for the reviewer

Checklist

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (solr)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (huggingface_api)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (anthropic)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (oracle)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (ragas)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (funasr)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (valkey)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (elasticsearch)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (whisper)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (azure_doc_intelligence)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (supabase)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (hanlp)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (opensearch)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (spacy)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (vespa)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (optimum)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (sentence_transformers)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (ollama)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (docling)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (transformers)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (ibm_db)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (llama_stack)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (llama_cpp)

Uh oh!

github-actions Bot commented Oct 15, 2026

Coverage report (chonkie)

julian-risch commented Oct 15, 2026 •

edited

Loading