내 PC에서 프라이빗하게 고품질 AI 이미지를 무제한으로 생성할 수 있는 스테이블 디퓨전(Stable Diffusion) WebUI! 하지만 최근 파이썬 버전 충돌과 공식 저장소 증발 사태가 겹치면서 설치 과정에서 수많은 에러를 뿜어내고 있습니다.
오늘은 AUTOMATIC1111(A1111) 버전의 기본 설치 방법부터, 현재 전 세계 유저들을 괴롭히고 있는 가장 치명적인 2가지 오류의 완벽한 해결책까지 하나로 총정리해 드립니다. 이 글만 순서대로 따라오시면 무조건 설치에 성공하실 수 있습니다!
1. 필수 프로그램 사전 준비
설치를 시작하기 전, 아래 두 가지 프로그램이 PC에 깔려 있어야 합니다.
- Python 3.10.6: 스테이블 디퓨전과 가장 호환성이 좋은 버전입니다. 파이썬 홈페이지에서 다운로드 후, 설치 창 맨 아래의 "Add Python 3.10 to PATH" 체크박스를 반드시! 선택하고 설치해 주세요.
- Git (깃): Git 공식 홈페이지에서 Windows용 버전을 다운로드하고, 기본 설정(Next)으로 설치를 마칩니다.
2. 스테이블 디퓨전 기본 설치하기
- C드라이브나 용량이 넉넉한 드라이브에 영어 이름으로 된 빈 폴더를 하나 만듭니다. (예:
D:\StableDiffusion)
- 해당 폴더 안으로 들어가서, 파일 탐색기 상단의 주소창을 클릭하고
cmd를 입력한 뒤 엔터를 치면 검은색 명령 프롬프트 창이 열립니다.
- 아래 명령어를 복사해서 붙여넣고 엔터를 칩니다.
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
- 다운로드가 끝나면
stable-diffusion-webui라는 폴더가 생성됩니다. 그 안으로 들어가서 webui-user.bat (톱니바퀴 아이콘) 파일을 더블 클릭하면 본격적인 설치가 시작됩니다.
※ 주의: 만약 여기서 에러 없이 쭉쭉 설치가 진행되어 Running on local URL: http://127.0.0.1:7860 문구가 뜬다면 당신은 럭키비키! 하지만 요즘은 십중팔구 아래의 에러들을 만나게 됩니다. 당황하지 말고 아래 해결법을 따라오세요.
3. 치명적 오류 ①: Installing clip 무한 에러 (pkg_resources)
🚨 증상
설치 초반 Installing clip 단계에서 멈추더니 ModuleNotFoundError: No module named 'pkg_resources' 및 error: invalid command 'bdist_wheel' 같은 붉은 글씨가 쏟아지며 설치가 튕기는 현상입니다.
🔍 원인
파이썬의 최신 뼈대 도구(setuptools v80 이상)가 업데이트되면서 구버전 파일(pkg_resources)을 통째로 삭제해 버렸습니다. 이 때문에 과거 구조를 쓰는 CLIP 패키지가 조립되지 않아 발생하는 버전 호환성 충돌입니다.
✅ 해결 방법 (명령어 수동 입력)
설치 폴더(stable-diffusion-webui) 주소창에 다시 cmd를 입력해 검은 창을 열고, 아래 3개의 명령어를 순서대로 하나씩 입력(엔터)해 줍니다.
- 가상 환경(venv) 켜기: (입력 줄 맨 앞에
(venv)가 생겨야 합니다)
venv\Scripts\activate
- 설치 도구를 구버전으로 강제 다운그레이드:
pip install setuptools==69.5.1
- 파이썬 고립 환경을 무시하고 CLIP 강제 설치:
pip install https://github.com/openai/CLIP/archive/d50d76daa670286dd6cacf3bcd80b5e4823fc8e1.zip --no-build-isolation
Successfully installed clip 문구가 뜨면 성공입니다! 검은 창을 닫고 다시 webui-user.bat를 실행하세요.
4. 치명적 오류 ②: 원본 저장소 증발 및 깃허브 로그인 에러
🚨 증상
기분 좋게 1번 에러를 넘겼는데, 이번엔 뜬금없이 웹 브라우저가 열리며 GitHub 로그인을 요구합니다. 로그인을 안 하면 Repository not found 에러를 뿜으며 튕겨버립니다.
🔍 원인
놀랍게도 스테이블 디퓨전 원작자(Stability AI) 측에서 공식 깃허브 원본 저장소를 숨기거나 지워버렸습니다. 파일 자체가 서버에 없으니 다운로드 프로그램(Git)이 "비공개 파일인가?" 착각하고 로그인 팝업을 띄운 것입니다.
✅ 해결 방법 (백업 미러 서버 사용)
유저들이 만들어둔 백업(Mirror) 주소로 파일을 받아오면 깔끔하게 해결됩니다. 이번엔 venv를 켤 필요 없이, 설치 폴더에서 cmd를 열고 아래 명령어를 길게 한 줄 그대로 복사/붙여넣기 하세요.
git clone https://github.com/w-e-w/stablediffusion.git D:\Work\StableDiffusion\stable-diffusion-webui\repositories\stable-diffusion-stability-ai
⚠️ 매우 중요: 명령어를 치고 다운로드가 진행되는 도중, 또 GitHub 로그인 팝업이 뜬다면 절대 로그인하지 말고 창의 X를 누르거나 Cancel(취소)을 누르세요. 취소를 눌러야 다운로드가 마저 100%까지 완료됩니다.
5. 최종 실행 및 모델 적용하기
여기까지 오셨다면 최악의 에러 고비는 모두 넘겼습니다! 🎉
- 열려있는 cmd 창을 모두 닫고, 폴더 안의
webui-user.bat를 다시 실행합니다.
- 나머지 필수 파일들이 에러 없이 쭉쭉 다운로드됩니다.
- 마지막에 검은 창에
Running on local URL: http://127.0.0.1:7860 문구가 나타나면 설치 성공입니다!
- 인터넷 브라우저(크롬 등) 주소창에 저 주소를 복사해 넣으면 드디어 스테이블 디퓨전 WebUI 화면을 만날 수 있습니다.
💡 꿀팁: 멋진 실사나 애니메이션 그림을 뽑고 싶다면 Civitai 같은 사이트에서 체크포인트 모델 파일(.safetensors)을 다운받아 \models\Stable-diffusion 폴더에 넣고 WebUI 왼쪽 위의 새로고침 버튼을 누르면 적용됩니다.
설치하시느라 정말 고생 많으셨습니다. 이제 쾌적한 로컬 환경에서 마음껏 AI 이미지를 생성해 보세요!