You can use any model from Hugging Face in your pipelines. There are a couple of ways to do it:

• You can download a model from Hugging Face and then pass its location to the pipeline component that uses it.
• You can use one of Hugging Face's APIs:
  • Free Serverless Inference API
  • Paid Inference Endpoints
  • Self-hosted Text Embedding Inference

Prerequisites

You need a Hugging Face token for the API you want to use.

Use Models from Hugging Face

Connect deepset AI Platform to Hugging Face through the Integrations page. You can do so for a single workspace or for the whole organization:

For details, see Add Integrations.

Then, add a component that uses the model you have in mind. Here are the available components by the model type:

• Embedding models:
  • HuggingFaceAPIDocumentEmbedder: Computes document embeddings using Hugging Face's APIs.
  • HuggingFaceAPITextEmbedder: Computes text embeddings using Hugging Face's APIs.
  • OptimumDocumentEmbedder: Calculates document embeddings using models from Hugging Face's Optimum library. You can use it through Hugging Face's APIs.
  • OptimumTextEmbedder: Calculates text embeddings using models from Hugging Face's Optimum library. You can use it through Hugging Face's APIs.
  • SentenceTransformersDocumentEmbedder: Embeds documents using Sentence Transformers models. You can use it through Hugging Face's APIs.
  • SentenceTransformersTextEmbedder: Embeds text using Sentence Transformers models. You can use it through Hugging Face's APIs.

• Named entity extraction:
  • NamedEntityExtractor: Can work with Hugging Face models if you set its backend parameter to hugging_face.
• LLMs:
  • HuggingFaceAPIChatGenerator: Completes chats using Hugging Face APIs.
  • HuggingFaceAPIGenerator: Uses text-generating models through Hugging Face APIs.
  • HuggingFaceLocalChatGenerator: Uses a Hugging Face chat-completion model that runs locally.
  • HuggingFaceLocalGenerator: Generates text using a Hugging Face model that runs locally.
• Ranking models:
  • TransformersSimilarityRanker: Uses a cross-encoder model to rank documents. You can use models through Hugging Face APIs.
  • SentenceTransformersDiversityRanker: Uses a sentence transformers model to rank documents. You can use models through Hugging Face APIs.
• Readers:
  • ExtractiveReader: Extracts answers from the text.
• Routers:
  • TransformersTextRouter: Routes text to various outputs based on a categorization label provided by the model it uses.
  • TransformersZeroShotTextRouter: Uses a text classification model to route text to various outputs based on user-defined labels.

Usage Examples

Check the documentation of the component you want to use for usage examples.