chore: deprecate HF API components + update docs

[anakin87]

Related Issues

• part of https://github.com/deepset-ai/haystack-private/issues/365

Proposed Changes:

• deprecate HF API component and point users to the new package (not for Generator, already deprecated, will be removed)
• update docs to just show the new package

How did you test it?

CI

Checklist

• I have read the contributors guidelines and the code of conduct.
• I have updated the related issue with new insights and changes.
• I have added unit tests and updated the docstrings.
• I've used one of the conventional commit types for my PR title: fix:, feat:, build:, chore:, ci:, docs:, style:, refactor:, perf:, test: and added ! in case the PR includes breaking changes.
• I have documented my code.
• I have added a release note file, following the contributors guidelines.
• I have run pre-commit hooks and fixed any issue.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
haystack-docs	Ready	Preview, Comment	Jun 5, 2026 10:40am

[github-actions]

Coverage report

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
haystack/components/embedders
hugging_face_api_document_embedder.py
hugging_face_api_text_embedder.py
haystack/components/generators/chat
hugging_face_api.py
haystack/components/rankers
hugging_face_tei.py
Project Total

This report was generated by python-coverage-comment-action

[claude]

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.