📌 Hugging Face CLI를 이용한 모델 다운로드

Hugging Face CLI 설치

먼저, Hugging Face CLI를 설치합니다.

pip install huggingface_hub

Hugging Face 로그인

로그인 후 액세스 토큰을 입력합니다.

huggingface-cli login

로그인 과정에서 Hugging Face Access Token을 입력해야 합니다.

👉 토큰 발급 링크

Stable Diffusion XL Base 1.0 다운로드
특정 모델 파일(sd_xl_base_1.0.safetensors)만 로컬 디렉토리에 저장합니다.

huggingface-cli download stabilityai/stable-diffusion-xl-base-1.0 \
    --local-dir checkpoints --include "sd_xl_base_1.0.safetensors"

🔹 설명

stabilityai/stable-diffusion-xl-base-1.0: 다운로드할 모델의 Hugging Face 저장소 이름
--local-dir checkpoints: 다운로드한 파일을 저장할 로컬 디렉토리 (checkpoints)
--include "sd_xl_base_1.0.safetensors": 특정 파일만 다운로드
이제 checkpoints 폴더 안에 Stable Diffusion XL Base 1.0 모델 파일이 저장됩니다. 🚀

만약 -> --local-dir뒤에 .하면 현재 경로에 다운로드.

만약 huggingface <- download안된다?

=-> 무조건 linux python을 다운로드 하고 이를 통해서 해야함.

---

huggingface 다운했는데 안된다.

이 문제는 huggingface 라이브러리와 Hugging Face CLI(huggingface-cli)가 서로 다른 패키지라는 점에서 발생한 것입니다.

🔍 요약하자면:

• pip install huggingface는 Hugging Face와 무관한 3rd-party 패키지 (버전 0.0.1)입니다.
  → 이건 잘못 설치된 것입니다.
• huggingface-cli 명령어는 Hugging Face의 공식 Python 라이브러리인 huggingface_hub 또는 transformers를 설치해야 사용할 수 있습니다.

✅ 올바른 설치 방법

pip install huggingface_hub

또는 transformers도 같이 필요하다면:

pip install transformers

설치 후 다음 명령어로 로그인:

huggingface-cli login

🧼 잘못 설치한 huggingface 제거

pip uninstall huggingface

---

✅ 요약

목적	설치할 패키지	명령어
Hugging Face CLI 사용 (huggingface-cli)	huggingface_hub	pip install huggingface_hub
Transformers 등 모델 사용	transformers	pip install transformers
실수로 설치된 잘못된 패키지	huggingface	pip uninstall huggingface

그래도 안된다?

✅ 1. huggingface_hub가 설치됐는지 확인

먼저 이걸로 확인해봐:

pip show huggingface_hub

• 안 뜨면 설치부터 해야 해:

pip install --upgrade huggingface_hub

---

✅ 2. 설치됐는데도 huggingface-cli 안 되는 경우

이건 CLI 바이너리가 PATH에 없어서 그래. 일반적으로 pip install하면 CLI 툴이 ~/.local/bin에 깔리는데, 이 경로가 PATH에 없으면 명령어 못 씀.

🔍 해결법 1: 직접 실행

~/.local/bin/huggingface-cli

→ 이게 되면 그냥 PATH에 해당 경로를 추가하면 돼.

✅ 3. PATH에 추가하는 법

echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc
source ~/.bashrc

zsh 쓰고 있다면 .zshrc에 넣어야 해.

✅ 4. 여전히 안 되면

혹시 sudo pip나 다른 Python 환경 썼을 수도 있으니, 이걸로 경로 한번 확인:

which huggingface-cli

또는,

find ~ -name huggingface-cli

---

🔧 그래도 안 될 때

직접 Python에서 CLI 실행 가능:

python -m huggingface_hub.hf_cli

🧹 참고로 아까 설치했던 huggingface (0.0.1)는 잘못된 패키지니까 제거해도 돼:

pip uninstall huggingface