# hf_fast_gui

**Repository Path**: xy506/hf_fast_gui

## Basic Information

- **Project Name**: hf_fast_gui
- **Description**: 通过国内镜像加速下载Hugging Face大模型的GUI小型程序，基于官方sh脚本使用AI改写而成。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 项目概述
这是一个 **Hugging Face 加速下载工具**，使用 Python + Tkinter + ttkbootstrap 构建的 GUI 应用程序。

### 核心架构

**1. FileManager 类** - 文件管理
- 维护文件名到 item_id 的映射
- 智能文件名匹配算法（完全匹配、基本文件名匹配、包含关系匹配）
- 从 aria2 输出中提取文件名

**2. DownloadManager 类** - 下载管理
- 使用 aria2c 进行多线程下载
- 支持并发下载和断点续传
- 实时解析 aria2 输出并更新文件状态

**3. HFFastDownloader 类** - 主 GUI 应用
- 基于 ttkbootstrap 的现代化界面
- 三个标签页：下载设置、下载日志、使用帮助

### 主要功能

- **仓库下载**：支持 Hugging Face 模型和数据集下载
- **文件过滤**：支持包含/排除模式过滤文件
- **加速下载**：通过 aria2 实现多线程并发下载
- **进度显示**：实时显示下载进度和状态
- **日志记录**：完整的下载日志记录
- **API 镜像**：支持自定义 API Endpoint（默认 hf-mirror.com）

### 技术特点

- 使用 `ttkbootstrap` 提供现代化的 UI 主题
- 智能文件名匹配算法处理 aria2 输出
- 支持右键菜单（复制、粘贴、全选）
- 自动检测和安装 aria2
- 完整的依赖检查机制