在使用当前 PyPI 的 `import gradio` 时出现了 ImportError: huggingface_hub 1.x 移除了 HfFolder

作者: os8ai创建于 2026年5月3日更新于 2026年6月14日

□ 总结

requiments-app.txt'的新鲜安装目前已损坏:进口gradio'提出进口错误:不能在app.py'运行前从huggingface hub'导入'Hffolder'的名称。 固定点是requires-app.txt'中上方的一针。

□再现者.

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? git Cloom https://GitHub.com/Zeyi-Lin/Hivisi-DPhotos.git 互联网档案馆的存檔,存档日期2013-12-22. cd 喜视影视 git取出 v1.3.1 (中文(简体) ). python3.12 - m venv.venv - .venv/bin/activate (英语). pip 安装 -r 要求.txt -r 要求-app.txt Python app.py -- -- 主机 127.0.0.1 -- -- 港口 7860


结果 :

文件"<.>/.venv/lib/python3.12/ site-packages/gradio/oauth.py", 第13行,以"模块"为单位. 从拥抱面 hub 导入 Hffolder, whoami 导入错误: 无法从“ huggingface hub” 导入“ Hffolder” 名称


□ 根源

===================================================================================================================================================
|.
`要求-适用.txt' `gradio 4.43.0'(无上限) `gradio 6.x'今天 `show api=False' (单独问题)' |
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
################################################################################################################################################################################################################################################################
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

`gradio/oauth.py' in 4.x 进口 " Hfolder " 在模块顶级,因此`进口gradio'触发了链条并失效。

已验证 :
- 拥抱面-hub 0.36.2(后期为0.x):出口 " Hffolder " (4起引文载于--init-.py)
- 拥抱面- hub 1. 0.0+: 已删除 " Hfolder "
- Gradio 4.44.1's `oauth.py':`从拥抱面 hub导入Hffolder, whoami'(并使用"Hffolder.get token ()")

□ 建议修正

在`requestments-app.txt'后增加一行:

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你来干什么?
格莱迪奥 4.43.0
+huggingface hub <1 组合键
禁药

`<1'解决了最高的0.x(目前为0.36.2). 0~1边界是"huggingface hub"中的犬形断裂换行,因此通过0.x安全补丁保持有效而不会被冻结到特定版本.

这是在Gradio 5在#187地盘上追踪到的升级之前的绕道, 此时正确的定律是,一旦Gradio 5 将它正确输入, 就可以将上方绑在拥抱面 hub上。

□ 相关

-187 —"升级为gradio 5.0"(长期固定;这个问题是当前安装的短期解封).

□ 内容

在为 HivisionIDPhotos 编写 OS8 App Store 目录时被浮出水面 。 我们一直围绕它开展工作,把gradio<5'和huggingface hub<1' 都写在我们清单的Install之后,但从requiments-app.txt'直接安装的任何人目前都被import gradio'封锁。

如果有用的话,很乐意发送公关.

内容来源: Zeyi-Lin/HivisionIDPhotos