[에러 해결] Python 3.12에서 kss 설치 오류 (pyyaml 의존성 문제)

 

Python 3.10 환경에서 $ pip install kss 명령어로 설치할 때는 잘 됐었는데,
Python 3.12 환경에서 시도하니 아래와 같은 에러가 발생했다.

...

pyyaml을 설치하는 과정에서 에러가 발생하는 것으로 보인다.

 

구글링을 통해 Windows 환경에서 pyenv를 통해 다른 버전의 Python을 설치해 해결하는 방법 (링크)을 찾았으나,
내가 처한 상황에서는 활용할 수 없는 방법이었다. 

 

다른 해결 방법을 찾던 중, kss 깃헙 레포에 정확히 이 문제에 대한 Issue (링크)가 올라와있는 것을 발견할 수 있었다!

위 글을 참고하면, 이 문제가 발생하는 원인은 kss는 pyyaml==6.0과 의존성이 있으나, Python 3.12 환경에서 pyyaml==6.0이 정상적으로 빌드되지 않기 때문이었다.

따라서 Issue 작성자께서 의존성을 pyyaml>=6.0.2 버전으로 수정하여 Pull Request를 올리셨는데, kss 개발자께서 아직 확인하지 못하신듯 하여 Merge가 되지는 않은 상태이다.
→ (25.03.31 Update) 어제 Merge가 된 것을 확인하였다!

Merge는 되었지만 pip에는 새 버전이 release되지 않은 상황이어서 (25.03.31 기준 최신버전: 6.0.4), 여전히 > pip install kss 명령어 실행 시 에러가 발생할 수 있다.

 

해결 방법은 다음의 명령어로 PR이 merge된 github 레포로부터 설치한다.

pip install git+https://github.com/hyunwoongko/kss.git

 

+ 만일 향후에 모듈 버전 업데이트로 인해 또 동일한 에러가 발생한다면, setup.py 파일에서 install_requires 값 내 해당하는 모듈의 버전을 직접 높여준다.

install_requires = [
    "emoji==1.2.0", "pecab", "networkx", "jamo",
    "hangul-jamo", "tossi", "distance", "pyyaml>=6.0.2", # 이전에는 "pyyaml==6.0"이어서 에러발생
    "unidecode", "cmudict", "koparadigm", "kollocate",
    "bs4", "numpy", "pytest", "scipy",
]