Skip to main content

HuggingFace Embeddings Configuration

HuggingFace Embeddings Configuration Interface The HuggingFace embeddings configuration screen in Novaplan AI where you’ll enter your Model Name Novaplan AI can use HuggingFace embedding models in the managed workspace without a separate inference API key. Provide the full HuggingFace model repository slug; Novaplan AI downloads the model and runs inference in its configured environment. Coordinate model availability and resource needs with Novaplan.

Required Fields

Model Name *

The Model Name field is the only required field. Enter the full HuggingFace model repository slug in the format owner/model-name. Popular HuggingFace embedding models include:
  • sentence-transformers/all-MiniLM-L6-v2 - Lightweight, fast general-purpose model (384 dimensions)
How to choose a model:
  • For general-purpose retrieval with low resource usage, select sentence-transformers/all-MiniLM-L6-v2
  • Browse the HuggingFace model hub for the full list of embedding models
  • Use the exact repository slug shown on the model’s HuggingFace page

Configuration Steps

As shown in the image above:
  1. Click Configure on the HuggingFace provider card
  2. Enter the full HuggingFace model repository slug in the Model Name field (marked with *) — e.g. sentence-transformers/all-MiniLM-L6-v2
  3. Click Add Model to save and validate
Model Name is the only required field. No API key or external service is needed — the model runs locally inside Novaplan AI.

Usage Considerations

  • Embedding inference runs in the Novaplan-managed workspace, without sending each request to a separate HuggingFace inference API
  • No API key or billing setup required
  • The model is downloaded from HuggingFace on first use; Novaplan must ensure the managed workspace can reach the model repository
  • Larger models provide better quality but require more memory and take longer to load

Troubleshooting

  • If the model fails to load, verify the repository slug is correct (e.g. sentence-transformers/all-MiniLM-L6-v2, not just all-MiniLM-L6-v2)
  • Ask Novaplan to verify that the managed workspace can reach huggingface.co to download the model on first use
  • For memory issues, switch to a smaller model
  • Check that the model supports the sentence embedding task (pipeline tag: sentence-similarity or feature-extraction)
For additional support, refer to the HuggingFace documentation or contact Novaplan AI support.