kohya_ss 경고메시지

이 경고 메시지는 **`kohya_ss` 프로젝트가 현재 "레거시 방식"으로 editable 설치**(`pip install -e`)되고 있기 때문에 발생합니다. 이는 **pip의 향후 버전**(25.3, 2025년 Q3 예정)에서 더 이상 지원되지 않을 방식을 사용하고 있다는 **경고**입니다.

---

### 🔍 원인 분석

경고 메시지의 핵심 내용:

```
DEPRECATION: Legacy editable install of library==0.0.0 from file:///C:/AI/kohya_ss/sd-scripts (setup.py develop) is deprecated.
```

- `kohya_ss` 또는 그 하위 디렉터리인 `sd-scripts` 폴더에 **`pyproject.toml` 파일이 없거나**,  
- 있더라도 **`[build-system]` 설정이 없거나**,  
- 또는 `setuptools` 버전이 **64.0.0 미만**이라서  
  → pip이 **구식 방법인 `setup.py develop`을 사용**해 editable 설치를 수행하고 있습니다.

이 방식은 이제 **PEP 660 기반의 새로운 표준 방식**으로 대체되고 있으며, pip 25.3부터는 완전히 제거될 예정입니다.

---

### ✅ 해결 방법

#### ✅ 방법 1: `pyproject.toml` 파일 추가 **(권장)**

`sd-scripts` 폴더(또는 해당 editable 설치 대상 폴더)에 다음 내용의 `pyproject.toml` 파일을 만드세요:

```toml
[build-system]
requires = ["setuptools >= 64", "wheel"]
build-backend = "setuptools.build_meta"
```

> 💡 `setuptools >= 64`는 PEP 660을 지원하는 최소 버전입니다.

이렇게 하면 pip이 자동으로 **새로운 editable 설치 방식**을 사용하게 되고, 경고가 사라집니다.

---

#### ✅ 방법 2: 설치 시 `--use-pep517` 플래그 사용

만약 파일 수정이 어렵다면, 설치 명령어에 다음 옵션을 추가하세요:

```bash
pip install -e ./sd-scripts --use-pep517
```

또는 `requirements.txt`를 통해 설치할 때는 직접 실행 스크립트를 수정하거나, 환경 변수/설정을 통해 이 옵션을 전달해야 할 수 있습니다.

> ⚠️ 단, pip 25.3 이후에는 `--use-pep517` 없이도 항상 새로운 방식이 강제되므로, **장기적으로는 방법 1이 더 안정적**입니다.

---

#### ✅ 방법 3: 호환 모드 사용 **(임시 조치)**

만약 새 방식으로 설치했을 때 동작이 이상하다면, 다음과 같이 **호환 모드**를 켤 수 있습니다:

```bash
pip install -e ./sd-scripts --config-settings editable_mode=compat
```

이 옵션은 setuptools가 구식 `setup.py develop`과 유사한 방식으로 editable 설치를 수행하도록 합니다.

---

### 📌 요약

| 문제 | 해결책 |
|------|--------|
| `setup.py develop` 기반 editable 설치 사용 중 | `pyproject.toml` 추가 + `setuptools >= 64` 명시 |
| pip 25.3 이후 설치 실패 우려 | 위 설정으로 사전 대응 |
| 동작 이상 시 | `--config-settings editable_mode=compat` 사용 |

---

### 🔗 참고

- 공식 이슈: https://github.com/pypa/pip/issues/11457 
- PEP 660: Editable installs standard  
- Setuptools 문서: editable install 관련 설정 확인

필요하시면 `pyproject.toml` 예시나 설치 스크립트 수정도 도와드릴 수 있어요!

 

 

**************학습중 에러 발생____________중요함

이 에러는 **TensorFlow의 네이티브 DLL 로드 실패**로 인해 발생하는 문제입니다.  
특히 다음 메시지가 핵심입니다:

> ```
> ImportError: DLL load failed while importing _pywrap_tensorflow_internal: DLL 초기화 루틴을 실행할 수 없습니다.
> ```

---

## 🔍 원인 분석 (Windows + Python 3.10 환경 기준)

### ✅ 가능한 주요 원인

1. **TensorFlow 버전과 Python/Windows/Visual C++ 런타임 호환성 문제**  
   - TensorFlow는 특정 Python 버전(3.8~3.11)과 **Microsoft Visual C++ 재배포 가능 패키지**(2015–2022)를 요구합니다.
   - 특히 **Python 3.10 + TensorFlow 2.10 이상** 조합에서 자주 발생.

2. **CPU가 AVX/AVX2 명령어를 지원하지 않거나, TensorFlow가 해당 CPU에 맞지 않음**  
   - 구형 CPU(예: Intel 1세대 Core, AMD FX 이전)는 AVX 미지원 → 공식 pip TensorFlow 패키지 실행 불가.

3. **GPU 드라이버 / CUDA / cuDNN 충돌 **(하지만 이 경우는 CPU-only 에러로 보임)

4. **가상환경 충돌 또는 잘못된 설치**

---

## 🛠️ 해결 방법

### ✅ 1. **Visual C++ 재배포 가능 패키지 설치 확인**

- [Microsoft Visual C++ 재배포 가능 패키지 최신 버전](https://aka.ms/vs/17/release/vc_redist.x64.exe) (x64용) 설치
- 이미 설치되어 있다면 **재설치** 권장

---

### ✅ 2. **TensorFlow 버전 다운그레이드 **(Python 3.10 사용 시)

공식 TensorFlow는 **Python 3.10까지 지원하지만**,  
**Windows에서 안정적인 버전은 `2.10`이 마지막**입니다. (`2.11+`는 Windows에서 공식 pip 제공 중단)

```bash
pip uninstall tensorflow
pip install tensorflow==2.10.1
```

> ⚠️ `tensorflow==2.11` 이상은 Windows에서 **공식 바이너리 없음** → 커뮤니티 빌드 사용 시 DLL 오류 발생 가능

---

### ✅ 3. **CPU가 AVX/AVX2를 지원하는지 확인**

- [CPU-Z](https://www.cpuid.com/softwares/cpu-z.html)로 CPU 정보 확인
- 명령어 세트에 **AVX** 또는 **AVX2** 포함 여부 확인
- **미지원 시**:  
  → 공식 TensorFlow 사용 불가  
  → 대안: [Intel의 최적화된 TensorFlow](https://github.com/intel/tensorflow) 또는 **AVX 없이 빌드된 커스텀 TensorFlow** 사용

---

### ✅ 4. **kohya_ss는 사실 TensorFlow를 사용하지 않습니다**!

> 💡 **중요!**  
> `kohya_ss`는 **PyTorch 기반**입니다.  
> 그런데도 TensorFlow 오류가 나는 이유는?

- 일부 의존성 라이브러리(예: `accelerate`, `datasets`, `tokenizers`)가 **TensorFlow를 선택적으로 설치**했을 수 있음
- 또는 **다른 프로젝트와 가상환경을 공유**해서 TensorFlow가 설치된 상태

### 🔧 해결책:
```bash
# TensorFlow 완전 제거
pip uninstall tensorflow tensorflow-cpu tensorflow-gpu

# kohya_ss에 필요한 패키지만 재설치
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121 # CUDA 12.1 예시
pip install -r requirements.txt  # kohya_ss 폴더 내 requirements.txt 사용
```

> ✅ **가상환경 새로 만들기**를 강력히 추천합니다:
```bash
python -m venv kohya_env
kohya_env\Scripts\activate
pip install --upgrade pip
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt
```

---

### ✅ 5. **accelerate 명령어 대신 직접 실행 시도**

`accelerate` CLI가 불필요한 의존성(예: TensorFlow)을 끌어올 수 있습니다.  
대신 **직접 Python 스크립트 실행**:

```bash
python C:/AI/kohya_ss/sd-scripts/sdxl_train_network.py --config_file C:/AI/kohya_ss/models/config_lora-20251020-190657.toml
```

---

## 📌 요약: 가장 빠른 해결법

1. **TensorFlow 제거**: `pip uninstall tensorflow`
2. **가상환경 새로 생성 + PyTorch만 설치**
3. **Visual C++ 재배포 패키지 설치**
4. **accelerate 대신 직접 `python sdxl_train_network.py` 실행**

---

필요하시면 **가상환경 설정 스크립트**나 **requirements.txt 점검**도 도와드릴게요!  
지금 사용 중인 **CUDA 버전**이나 **GPU 모델**(NVIDIA?)도 알려주시면 더 정확히 안내 가능합니다 😊