일부 MacOS, Windows 및 Linux (Arm & Amd64) 바이너리 (Binaries): https://github.com/blackbeardlabs/hf-downloader/releases/tag/v1.0.2
소스 코드 (Source code): https://github.com/blackbeardlabs/hf-downloader
터미널에서 직접 실행하거나, 직접 바이너리를 빌드하여 실행할 수도 있고, 제가 빌드한 바이너리를 다운로드하여 실행할 수도 있습니다. 선택은 여러분의 몫입니다.

제가 이 앱을 만든 이유는 집 인터넷이 상당히 불안정하기 때문입니다. 가끔 타임아웃 (timeout)이 발생하는데, 연결 상태가 나빠지거나 느려지면 파일을 계속 다운로드할 수 있도록 수동으로 다운로드를 일시 중지하고 재개해야 합니다. 하지만 제가 믿기 힘드시겠지만, 가끔 출근을 하거나 집을 비우고 심지어 잠을 잘 때도 있기 때문에 이것이 항상 실용적인 것은 아닙니다.

이 앱은 연결 문제를 자동으로 감지하여 필요할 때마다 다운로드를 일시 중지 및 재개합니다.

저는 특히 HuggingFace를 위해 이 앱을 만들었지만, 인터넷에서 다운로드하고 싶은 다른 어떤 링크에도 사용할 수 있습니다. 앱을 더 잘 이해하려면 아래의 기능을 확인해 보세요.

참고로, 이것은 완전히 오픈 소스 (open source)입니다. 여러분이 원하는 대로 무엇이든 할 수 있습니다. 심지어 판매하더라도 상관하지 않습니다.

저는 M4 Macbook Air와 Linux Mint 22.3 머신에서 테스트했습니다. Windows 머신에서는 테스트하지 않았지만, 별다른 문제는 없을 것이라고 생각합니다.

즐겁게 사용하세요...
(GLM 5.2 xhigh & Codex 5.5 High로 빌드됨)

기능

HF Downloader는 Hugging Face 저장소(repositories) 및 기타 모든 파일을 위한 로컬 다운로드 관리자입니다. 이 앱은 완전히 여러분의 머신에서 실행됩니다 — 계정, 클라우드, 텔레메트리 (telemetry)가 필요 없습니다.

Hugging Face에서 다운로드

• 저장소 ID (repo ID)를 통해 모델 (models), 데이터셋 (datasets), 스페이스 (spaces)를 다운로드합니다.
• 리비전 (revision, 브랜치 또는 커밋)을 선택합니다.
• 컴퓨터의 대상 폴더를 선택합니다.
• include 및 exclude 패턴(예: *.safetensors, *.json)으로 파일을 필터링합니다.
• 다운로드 전에 파일 목록을 미리 보고 원하는 파일을 정확히 선택합니다.
• 미리보기를 사용하여 전체 선택, 필터링된(visible) 파일만 선택 또는 항목 체크 해제를 할 수 있습니다.

URL로 모든 파일 다운로드

• URL 목록을 붙여넣고 모두 하나의 폴더로 다운로드합니다.

• 정리를 위해 작업(job)에 이름을 지정할 수 있습니다.

다운로드 제어

• 작업의 시작, 일시 중지, 재개, 취소 및 삭제를 지원합니다.
• 재개(Resume) 기능은 부분적인 파일로부터 이어서 진행하므로, 이미 다운로드된 파일을 다시 받을 필요가 없습니다.
• 다운로드 도중 앱이 종료되더라도, 작업은 일시 중지 상태로 유지되어 언제든 재개할 수 있습니다.

실시간 진행 상황

• 활성 파일에 대해 다운로드된 바이트(bytes), 전체 크기, 진행률(percentage), 현재 속도를 확인할 수 있습니다.
• 작업 테이블(jobs table)에서 현재 진행 중인 다운로드의 속도를 보여줍니다.
• 작업 상세 보기(job detail view)에서는 모든 파일의 상태, 크기, 다운로드된 양을 목록으로 제공합니다.

스마트 자동 재시작 (Smart auto-restart)

• 멈추거나 속도가 느려지는 다운로드를 자동으로 재시작합니다.
• 두 가지 규칙: 저속(low-speed) 및 평균 하락(average-drop)이며, any 또는 all 매칭 방식을 지원합니다.
• 파일당 및 작업당 재시작 횟수 제한과 쿨다운(cooldown)을 설정할 수 있습니다.
• 기본적으로 비활성화되어 있으며, 설정(Settings)에서 켤 수 있습니다.

설계 단계부터 고려된 프라이버시 (Private by design)

• 사용자의 Hugging Face 토큰은 오직 사용자의 기기에만 저장됩니다.
• 토큰은 브라우저로 다시 전송되지 않으며, 저장 후에는 다시 표시되지 않습니다.
• 계정, 동기화, 클라우드 서비스, 트래킹이 전혀 없습니다.

입력 내용 기억

• 앱은 양식(forms)에 입력한 내용을 저장하므로, 새로고침을 해도 저장소(repo), 폴더, 필터 설정이 유지됩니다.
• Reset defaults 버튼을 통해 자동 재시작 설정을 복구할 수 있습니다.

데스크톱 앱

• Windows, macOS, Linux에서 사용할 수 있습니다.
• Linux 빌드는 64비트(x64) 및 ARM(arm64) 컴퓨터를 위한 .deb 및 .AppImage 형식으로 제공됩니다.
• Windows 빌드는 설치형(installer) 또는 포터블 실행 파일(portable executable)로 제공됩니다.
• macOS 빌드는 .dmg 형식으로 제공됩니다.
• aria2c(다운로드 엔진)가 없는 경우, 플랫폼이 지원한다면 앱에서 원클릭 설치 버튼을 보여주거나 수동으로 실행할 명령어를 표시합니다.

간편한 실행

• 설치 후 바로 열어서 사용할 수 있으며, 일반적인 사용에는 별도의 설정이 필요하지 않습니다.

• 고급 옵션(포트, 다운로드 루트, aria2 타임아웃)은 필요한 사용자를 위해 제공됩니다.

  submitted by /u/BlackBeardAI
  [link] [comments]