Skip to content

huggingface-hub dependency error in gradio-lite #12262

Description

@ademait

Describe the bug

Hello, I have a Gradio app deployed with GitHub pages and Gradio Lite. It worked really fine. But since the major update of huggingface-hub library (from 0.35 to 1.0) a couple of weeks ago, the gradio-lite library is throwing an error since it does not support version above 1.0.

In the website I have hosted with GitHub pages, the first time it is loaded with no errors, but after the first time it shows the following error:


Error

Traceback (most recent call last): File "/lib/python3.12/site-packages/micropip/package_manager.py", line 133, in install return await install( ^^^^^^^^^^^^^^ File "/lib/python3.12/site-packages/micropip/install.py", line 57, in install raise ValueError( ValueError: Can't find a pure Python 3 wheel for: 'huggingface-hub<1.0,>=0.33.5' See: https://pyodide.org/en/stable/usage/faq.html#why-can-t-micropip-find-a-pure-python-wheel-for-a-package

D/e.onmessage@https://cdn.jsdelivr.net/npm/@gradio/lite/dist/assets/webworker-S4bilnnk.js:390:312

I find this behavior really weird, since I don't understand why the first time it loads it with no trouble (I have tried several times, clearing the cache, restarting the PC, etc.) and it happens every time. However, focusing on the error, it says that it can't find a python wheel, but the huggingface-hub library provides one (check download files of the package page in pypi).

So I tried to reproduce the error locally. I created a conda environment with the packages I will share below. In here the full traceback error is:

Traceback (most recent call last): File "/lib/python3.12/site-packages/micropip/package_manager.py", line 133, in install return await install( ^^^^^^^^^^^^^^ File "/lib/python3.12/site-packages/micropip/install.py", line 53, in install await transaction.gather_requirements(requirements) File "/lib/python3.12/site-packages/micropip/transaction.py", line 55, in gather_requirements await asyncio.gather(*requirement_promises) File "/lib/python3.12/site-packages/micropip/transaction.py", line 68, in add_requirement await self.add_wheel(wheel, extras=set(), specifier="") File "/lib/python3.12/site-packages/micropip/transaction.py", line 271, in add_wheel await self.gather_requirements(wheel.requires(extras)) File "/lib/python3.12/site-packages/micropip/transaction.py", line 55, in gather_requirements await asyncio.gather(*requirement_promises) File "/lib/python3.12/site-packages/micropip/transaction.py", line 59, in add_requirement return await self.add_requirement_inner(req) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/lib/python3.12/site-packages/micropip/transaction.py", line 141, in add_requirement_inner satisfied, ver = self.check_version_satisfied(req) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/lib/python3.12/site-packages/micropip/transaction.py", line 86, in check_version_satisfied raise ValueError( ValueError: Requested 'huggingface-hub<1.0,>=0.33.5', but huggingface-hub==1.1.2 is already installed

D/e.onmessage@https://cdn.jsdelivr.net/npm/@gradio/lite/dist/assets/webworker-S4bilnnk.js:390:312

So, it seems that gradio-lite does not allow huggingface-hub>=1.0. I would like to know whether you are aware of this, and if in the future it will be solved.

PS: I have search for similar issue, only finding #12127 but it encountered the same problem in Gradio playground, not on gradio-lite.

Have you searched existing issues? 🔎

  • I have searched and found no existing issues

Reproduction

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Governance DSL Form Builder</title>
    <script type="module" crossorigin src="https://cdn.jsdelivr.net/npm/@gradio/lite/dist/lite.js"></script>
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@gradio/lite/dist/lite.css" />
    <style>
        html, body {
            height: 100%;
            margin: 0;
            padding: 0;
        }
        body {
            display: flex;
            flex-direction: column;
        }
        gradio-lite {
            flex: 1;
            display: flex;
        }
    </style>
</head>
<body>
    <gradio-lite>
     .... python code (not relevant)
</gradio-lite>
</body>
</html>

Screenshot

No response

Logs

System Info

Gradio Environment Information:
------------------------------
Operating System: Windows
gradio version: 5.49.1
gradio_client version: 1.13.3

------------------------------------------------
gradio dependencies in your environment:

aiofiles: 24.1.0
anyio: 4.11.0
audioop-lts: 0.2.2
brotli: 1.1.0
fastapi: 0.117.1
ffmpy: 0.6.1
gradio-client: 1.13.3
groovy: 0.1.2
httpx: 0.28.1
huggingface-hub: 1.0.1
jinja2: 3.1.6
markupsafe: 3.0.2
numpy: 2.3.3
orjson: 3.11.3
packaging: 25.0
pandas: 2.3.2
pillow: 11.3.0
pydantic: 2.11.9
pydub: 0.25.1
python-multipart: 0.0.20
pyyaml: 6.0.2
ruff: 0.13.1
safehttpx: 0.1.6
semantic-version: 2.10.0
starlette: 0.48.0
tomlkit: 0.13.3
typer: 0.19.2
typing-extensions: 4.15.0
uvicorn: 0.37.0
mcp is not installed.
pydantic: 2.11.9
authlib is not installed.
itsdangerous is not installed.


gradio_client dependencies in your environment:

fsspec: 2025.9.0
httpx: 0.28.1
huggingface-hub: 1.0.1
packaging: 25.0
typing-extensions: 4.15.0
websockets: 15.0.1

Severity

Blocking usage of Gradio

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions