chore!: remove HF API components (moved to integrations)

.github/workflows/slow.yml

@@ -60,19 +60,14 @@ jobs:
               - "haystack/components/audio/whisper_local.py"
               - "haystack/components/classifiers/zero_shot_document_classifier.py"
               - "haystack/components/converters/tika.py"
-              - "haystack/components/embedders/hugging_face_api_document_embedder.py"
-              - "haystack/components/embedders/hugging_face_api_text_embedder.py"
               - "haystack/components/embedders/backends/sentence_transformers_backend.py"
               - "haystack/components/embedders/backends/sentence_transformers_sparse_backend.py"
               - "haystack/components/embedders/image/sentence_transformers_doc_image_embedder.py"
               - "haystack/components/embedders/sentence_transformers_text_embedder.py"
               - "haystack/components/embedders/sentence_transformers_sparse_document_embedder.py"
               - "haystack/components/embedders/sentence_transformers_sparse_text_embedder.py"
               - "haystack/components/evaluators/sas_evaluator.py"
-              - "haystack/components/generators/chat/hugging_face_api.py"
               - "haystack/components/generators/chat/hugging_face_local.py"
-              - "haystack/components/generators/hugging_face_api.py"
-              - "haystack/components/generators/hugging_face_local_generator.py"
               - "haystack/components/generators/openai_dalle.py"
               - "haystack/components/preprocessors/embedding_based_document_splitter.py"
               - "haystack/components/rankers/sentence_transformers_diversity.py"
@@ -86,17 +81,12 @@ jobs:
               - "test/components/audio/test_whisper_local.py"
               - "test/components/classifiers/test_zero_shot_document_classifier.py"
               - "test/components/converters/test_tika_doc_converter.py"
-              - "test/components/embedders/test_hugging_face_api_document_embedder.py"
-              - "test/components/embedders/test_hugging_face_api_text_embedder.py"
               - "test/components/embedders/image/test_sentence_transformers_doc_image_embedder.py"
               - "test/components/embedders/test_sentence_transformers_text_embedder.py"
               - "test/components/embedders/test_sentence_transformers_sparse_document_embedder.py"
               - "test/components/embedders/test_sentence_transformers_sparse_text_embedder.py"
               - "test/components/evaluators/test_sas_evaluator.py"
-              - "test/components/generators/chat/test_hugging_face_api.py"
               - "test/components/generators/chat/test_hugging_face_local.py"
-              - "test/components/generators/test_hugging_face_api.py"
-              - "test/components/generators/test_hugging_face_local_generator.py"
               - "test/components/generators/test_openai_dalle.py"
               - "test/components/preprocessors/test_embedding_based_document_splitter.py"
               - "test/components/rankers/test_sentence_transformers_diversity.py"

MIGRATION.md

@@ -40,6 +40,8 @@ component = NewComponent(new_param="value")
 - **One entry per breaking change.** Don't bundle unrelated changes into a single entry.
 - **Include a working code example** for every rename, removal, or signature change.
 - **Link to the PR** when extra context would help (e.g. `See [#1234](https://github.com/deepset-ai/haystack/pull/1234)`).
+- **Components moved to external packages** don't need a full entry: add a row to the table in
+  [Components Moved to External Packages](#components-moved-to-external-packages) instead.
 
 ---
 
@@ -71,6 +73,26 @@ from haystack.dataclasses import Document
 doc = Document(content="col\n1\n2\n3")
 ```
 
+### Components Moved to External Packages
+
+**What changed:** Some components have been moved out of Haystack into dedicated integration packages,
+hosted in the [haystack-core-integrations](https://github.com/deepset-ai/haystack-core-integrations) repository.
+
+**Why:** Moving these components to separate packages allows testing more thoroughly in isolation and
+releasing fixes independently of the Haystack release cycle. This also makes Haystack development and CI leaner.
+
+**How to migrate:** Install the new package and update your imports as shown in the table below.
+
+```bash
+pip install <new-package>
+```
+
+| Old import (`haystack-ai<3.0.0`) | New package | New import |
+|---|---|---|
+| `from haystack.components.generators.chat import HuggingFaceAPIChatGenerator` | `huggingface-api-haystack` | `from haystack_integrations.components.generators.huggingface_api import HuggingFaceAPIChatGenerator` |
+| `from haystack.components.embedders import HuggingFaceAPITextEmbedder` | `huggingface-api-haystack` | `from haystack_integrations.components.embedders.huggingface_api import HuggingFaceAPITextEmbedder` |
+| `from haystack.components.embedders import HuggingFaceAPIDocumentEmbedder` | `huggingface-api-haystack` | `from haystack_integrations.components.embedders.huggingface_api import HuggingFaceAPIDocumentEmbedder` |
+
 ### ToolInvoker component removed
 
 **What changed:** The `ToolInvoker` component has been removed. Imports from `haystack.components.tools`

haystack/components/embedders/__init__.py

@@ -10,8 +10,6 @@
 _import_structure = {
     "azure_document_embedder": ["AzureOpenAIDocumentEmbedder"],
     "azure_text_embedder": ["AzureOpenAITextEmbedder"],
-    "hugging_face_api_document_embedder": ["HuggingFaceAPIDocumentEmbedder"],
-    "hugging_face_api_text_embedder": ["HuggingFaceAPITextEmbedder"],
     "openai_document_embedder": ["OpenAIDocumentEmbedder"],
     "openai_text_embedder": ["OpenAITextEmbedder"],
     "sentence_transformers_document_embedder": ["SentenceTransformersDocumentEmbedder"],
@@ -23,8 +21,6 @@
 if TYPE_CHECKING:
     from .azure_document_embedder import AzureOpenAIDocumentEmbedder as AzureOpenAIDocumentEmbedder
     from .azure_text_embedder import AzureOpenAITextEmbedder as AzureOpenAITextEmbedder
-    from .hugging_face_api_document_embedder import HuggingFaceAPIDocumentEmbedder as HuggingFaceAPIDocumentEmbedder
-    from .hugging_face_api_text_embedder import HuggingFaceAPITextEmbedder as HuggingFaceAPITextEmbedder
     from .openai_document_embedder import OpenAIDocumentEmbedder as OpenAIDocumentEmbedder
     from .openai_text_embedder import OpenAITextEmbedder as OpenAITextEmbedder
     from .sentence_transformers_document_embedder import (