https://github.com/neverbiasu/hf-mirror-hub
https://github.com/neverbiasu/hf-mirror-hub
cli huggingface huggingface-datasets huggingface-hub huggingface-models huggingface-repository mirror pypi
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/neverbiasu/hf-mirror-hub
- Owner: neverbiasu
- Created: 2025-02-24T09:10:49.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-26T03:10:55.000Z (3 months ago)
- Last Synced: 2025-02-26T03:35:16.989Z (3 months ago)
- Topics: cli, huggingface, huggingface-datasets, huggingface-hub, huggingface-models, huggingface-repository, mirror, pypi
- Language: Python
- Homepage:
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# hf-mirror-hub
一个从 Hugging Face 镜像站点快速下载模型和数据集的命令行工具。
## 特性
* 使用 Hugging Face 镜像站点加速下载
* 支持 `hf-transfer` 加速下载
* 支持指定保存目录
* 支持使用 Hugging Face Hub 访问令牌
* 自动转换软链接为实际文件
## 安装
### 从 PyPI 安装 (推荐)
```bash
pip install hf-mirror-hub
```
### 从源码安装
```bash
git clone https://github.com/neverbiasu/hf-mirror-hub.git
cd hf-mirror-hub
conda create -n hf-mirror-hub python=3.8 # 非必需，也可以用 venv 或者直接安装
conda activate hf-mirror-hub
pip install -e .
```
## 使用说明
### 基本用法 (下载模型)
```bash
hf-mirror-hub --model
```
### 完整参数
```bash
hf-mirror-hub --model --save_dir --token [--no-hf-transfer]
```
### 参数说明
* `--model`, `-M`: 可选，模型名称 (例如: `deepseek-ai/DeepSeek-R1-Distill-Qwen-32B`)
* `--save_dir`, `-S`: 可选，保存目录路径 (默认为 `data`)
* `--token`, `-T`: 可选，Hugging Face 访问令牌 (用于访问私有模型或数据集)
* `--no-hf-transfer`: 可选，禁用 `hf-transfer` 加速
## 贡献
如果您认为仓库有什么可以修改或者优化的地方，可以提issues说明或fork本仓库更改后提PR。
## 许可证
MIT