预览
CLI 下载
uvx -p 3.13 --from pirateface pf download org/model
  • 向 Hugging Face 查询模型文件
  • 查找 Pirate Face 节点群中的节点
  • 节点群无法提供时回退到 Hugging Face
  • 将校验后的文件保存到 Hugging Face 缓存

你的 CI 要拉取一个 15 GB 的模型,从 Hugging Face 下载到一半卡住了,任务随之失败。Pirate Face 已将 37,174 个模型收录为种子,所以 Pirate Face CLI 可以从已经有这些文件的人那里拿到同样的文件,只有节点群给不了的部分才去 Hugging Face 取。

Pirate Face CLI 是通过种子分发模型的瑞士军刀。

代码无需改动

已经在用 transformers 或 huggingface_hub?照常从 Hugging Face 拉取。万一它宕机,节点群会接手。

你的脚本通过 piratefaceHugging Face首选Pirate Face 节点群备用Hugging Face备用Pirate Face 节点群首选

默认:每个文件从节点群下载,节点群无法提供时由 Hugging Face 补上。

安装 uv 后,把 pirateface 加进某次运行:

PF_HF_FIRST=1 uv run --with pirateface python your_script.py

或者用 pip 安装一次,并在环境中设置 PF_HF_FIRST=1,效果相同:

pip install pirateface

下载也可以单独进行。和 hf download 一样,这条命令把模型放进你的 Hugging Face 缓存:

uvx -p 3.13 --from pirateface pf download org/model

把 org/model 换成任意 Hugging Face 模型 ID。

不止下载

pf 能为你已有的模型做种。pf seed --hf-cache 会逐个处理 Hugging Face 缓存中的模型,每个做种前都先询问你。Pirate Face 尚未收录的模型,会顺便提交上去。

uvx -p 3.13 --from pirateface@latest pf seed --hf-cache
+积分+积分+积分你的磁盘Hugging Face 缓存其他人从你这里下载Pirate Face按做种时长计分新模型只需收录一次

磁盘不够用?pf work 会从救援队列取下一个模型,从 Hugging Face 流式读取,一个字节都不写入磁盘,然后制作种子并提交。

uvx -p 3.13 --from pirateface@latest pf work
救援队列一次一个模型Hugging Face流式读取文件pf work在内存中制作Pirate Face已收录,获得积分

你自己的模型也可以放上列表(pf submit --direct),你已经在做种的种子也会持续保持最新。

做种和救援工作都会在排行榜上获得积分。

就算我们也宕机

Pirate Face 也可能宕机。在你的机器上保留一份磁力索引副本,pirateface.co 没有响应时,pf download 会在副本里查找模型并直接加入它的节点群,每个分块都会与种子里的哈希核对。趁网站在线时运行一次,之后时不时再运行,就能获取新模型。

uvx -p 3.13 --from pirateface@latest pf index --sync
模型节点群照常送达pirateface.co离线你的机器带着索引副本

网站离线时,你的索引副本仍能找到模型,节点群仍会把它送达。

如果你不想记这些,可以让编程智能体阅读 skill.md,由它替你运行。

GitHub 上的源代码