uvx -p 3.13 --from pirateface pf download org/model你的 CI 要拉取一个 15 GB 的模型,从 Hugging Face 下载到一半卡住了,任务随之失败。Pirate Face 已将 37,174 个模型收录为种子,所以 Pirate Face CLI 可以从已经有这些文件的人那里拿到同样的文件,只有节点群给不了的部分才去 Hugging Face 取。
Pirate Face CLI 是通过种子分发模型的瑞士军刀。
代码无需改动
已经在用 transformers 或 huggingface_hub?照常从 Hugging 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磁盘不够用?pf work 会从救援队列取下一个模型,从 Hugging Face 流式读取,一个字节都不写入磁盘,然后制作种子并提交。
uvx -p 3.13 --from pirateface@latest pf work你自己的模型也可以放上列表(pf submit --direct),你已经在做种的种子也会持续保持最新。
做种和救援工作都会在排行榜上获得积分。
就算我们也宕机
Pirate Face 也可能宕机。在你的机器上保留一份磁力索引副本,pirateface.co 没有响应时,pf download 会在副本里查找模型并直接加入它的节点群,每个分块都会与种子里的哈希核对。趁网站在线时运行一次,之后时不时再运行,就能获取新模型。
uvx -p 3.13 --from pirateface@latest pf index --sync