llamaIndex - 💡(How to fix) Fix llama-index-embeddings-huggingface: references removed `huggingface-hub[inference]` extra [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
run-llama/llama_index#21549Fetched 2026-05-05 05:43:51
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Participants

Fix Action

Fix

Replace huggingface-hub[inference]>=0.19.0 with huggingface-hub>=0.19.0 in llama-index-embeddings-huggingface's dependencies.

Code Example

Requires-Dist: huggingface-hub[inference]>=0.19.0

---

warning: The package `huggingface-hub==1.13.0` does not have an extra named `inference`
RAW_BUFFERClick to expand / collapse

Problem

llama-index-embeddings-huggingface==0.6.1 declares:

Requires-Dist: huggingface-hub[inference]>=0.19.0

The [inference] extra was removed from huggingface-hub — it no longer exists in v1.x. The inference client was folded into the core package.

Current valid extras for huggingface-hub (v1.13.0): oauth, torch, fastai, hf-xet, mcp, testing, gradio, typing, quality, all, dev.

Impact

uv sync emits a warning on every install:

warning: The package `huggingface-hub==1.13.0` does not have an extra named `inference`

This is a warning, not a hard failure, since the functionality now ships in core. But strict dependency resolvers flag it and it causes confusion.

Fix

Replace huggingface-hub[inference]>=0.19.0 with huggingface-hub>=0.19.0 in llama-index-embeddings-huggingface's dependencies.

Environment

  • llama-index-embeddings-huggingface==0.6.1
  • huggingface-hub==1.13.0
  • uv==0.7.x

extent analysis

TL;DR

Update the dependency declaration in llama-index-embeddings-huggingface to remove the [inference] extra from huggingface-hub.

Guidance

  • Identify the dependency declaration in llama-index-embeddings-huggingface that includes the [inference] extra and update it to huggingface-hub>=0.19.0.
  • Verify that the updated dependency declaration resolves the warning emitted by uv sync.
  • Consider updating llama-index-embeddings-huggingface to a version that has already incorporated this fix, if available.
  • Review the list of valid extras for huggingface-hub (v1.13.0) to ensure no other dependencies are affected.

Example

No code snippet is necessary for this fix, as it involves updating a dependency declaration.

Notes

This fix assumes that the functionality provided by the [inference] extra is now included in the core huggingface-hub package, as stated in the issue.

Recommendation

Apply workaround: update the dependency declaration to remove the [inference] extra, as the inference client is now part of the core package.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

llamaIndex - 💡(How to fix) Fix llama-index-embeddings-huggingface: references removed `huggingface-hub[inference]` extra [1 participants]