开源了一个 Hugging Face 桌面客户端:断点续传下载、支持 hf-mirror、缓存可视化清理,全平台零遥测

分享一个自己写的开源项目:Oh My HuggingFace —— 一个非官方的 Hugging Face Hub 桌面客户端,macOS / Windows / Linux 全平台。

• 官网:https://ohmyhf.com


• 
  
  
  
  • GitHub:https://github.com/oh-my-hf/ohmyhf (Apache-2.0,求个 star)
  
  
  
  

为什么做这个

天天泡 HF Hub 的应该都懂:用浏览器下几十 GB 的模型权重太痛苦了——不能断点续传、没有队列、不能限速;HF 缓存目录悄悄吃掉几百 GB 硬盘也没个地方看;关注的组织和 Daily Papers 更新全靠手动刷网页。所以干脆写了个桌面端把这些都管起来。

对国内用户比较实用的一点

内置自定义 Hub 地址 + 代理设置:在「设置 → 网络」里把 Hub 地址改成 https://hf-mirror.com 就能直接走镜像浏览和下载,也可以单独配代理。Token 只会发给你配置的 endpoint 和 huggingface.co,不会带到 CDN 跳转目标上。

主要功能

• 下载管理器:断点续传、多线程并行、队列、限速、SHA-256 校验、系统通知。文件直接落在标准 HF 缓存目录结构里,transformers、huggingface-cli 等工具无缝复用,不搞私有格式。


• 
  
  
  
  • 缓存可视化:扫描本地 HF 缓存,按仓库看磁盘占用,一键清理过期 revision 。
  
  
  
  


• 
  
  
  
  • 三栏浏览:模型 / 数据集 / Spaces / Daily Papers,键盘优先(Cmd/Ctrl+K 命令面板),虚拟列表秒开,模型卡片即时渲染,文件树 + 文件预览。
  
  
  
  


• 
  
  
  
  • 关注 & 收件箱:关注用户 / 组织 / 仓库 / 论文,有更新发系统通知。
  
  
  
  


• 
  
  
  
  • 导出到本地工具链:下载完的模型一键导出给 Ollama 、LM Studio 、ComfyUI 。
  
  
  
  


• 
  
  
  
  • 模型对比:2–4 个模型并排比参数量、协议、下载量。
  
  
  
  


• 
  
  
  
  • 中英双语、深浅色主题、原生菜单,不是「网页套壳」的交互。
  
  
  
  

隐私与安全

毕竟要托管你的 HF token,这块做得比较严格:

• 零遥测、零统计,唯一的网络请求就是 Hub 本身;


• 
  
  
  
  • Token 用系统钥匙串加密(Electron safeStorage),0600 权限落盘,永远不进 localStorage 、不存明文;
  
  
  
  


• 
  
  
  
  • 渲染进程完全沙箱化(contextIsolation + 严格 CSP),网络和磁盘操作全部在主进程,走带校验的类型化 IPC;
  
  
  
  


• 
  
  
  
  • 本地数据(收藏、历史、下载任务)全在本地 SQLite,不出你的电脑。
  
  
  
  

下载安装

从 GitHub Releases 下载(当前 v0.0.8):

• macOS:.dmg(Apple Silicon)


• 
  
  
  
  • Windows:.exe
  
  
  
  


• 
  
  
  
  • Linux:.AppImage / .deb
  
  
  
  

macOS 提示:目前是自签名、未过 Apple 公证,首次打开需要右键 →「打开」,或者执行:

xattr -dr com.apple.quarantine "/Applications/Oh My HuggingFace.app"

最后

项目还很早期(v0.0.8),功能建议、bug 反馈、PR 都欢迎,i18n 翻译加一门语言只需要一个 JSON 文件夹。

声明:本项目为独立社区项目,与 Hugging Face, Inc. 无任何关联,未获其背书。