파이썬 Python wordcloud 설치 오류 실패기

python wordcloud 설치 시 발생하는 오류와 싸운 스토리.

안타깝게도 아래 방법으로는 해결을 하지 못했기 때문에, 혹시 M1이나 M2를 쓰시는 분들이라면 내 실패기를 읽고 시간을 절약하시기를.

해결책을 찾으면 댓글로 업데이트할 예정이다.

---

 

노트북을 mac으로 바꾸게 되었다.

공부를 하던 중에 wordcloud를 그려야 할 일이 생겼는데, 새 노트북의 문제는 패키지들도 처음부터 다 재설치해야한다는 것.

그 와중에 만난 각종 오류를 기재해본다.

 

1. java 미설치로 인한 오류 방지

wordcolud를 그리기 위해 설치해야하는 konlpy 패키지는 java를 필요로 한다. 나는 macOS & M2칩이라 Arm 64 DMG Installer를 이용해 설치해줬다. 그 덕분인지 Java로 인해 발생하는 오류는 없었다.

 

2. jupyterlab pip install wordcloud 오류

내게 발생한 오류는 아래와 같은 메세지였다. wordcloud 패키지 문제일 뿐 pip 문제는 아니라고 한다.

발생한 error명은 legacy-install-failure이다. subprocess-exited-with-error도 함께 발생했다.

Failed building wheel for wordcloud라는 에러도 눈에 띈다.

구글링을 한 결과, 오류의 해결법은 자신의 OS와 파이썬 버전에 맞는 wheel 파일을 설치하는 것이라고 한다.

먼저 내 파이썬 버전을 확인해보았다.

Iterm 창에서 아래 명령어를 이용해 현재 버전이 3.11임을 확인했다. (MacOS는 13.2.1)

python3 -version

 

wordcloud의 wheel 파일을 찾던 중 이런 메세지를 발견했다. 3.11 버전으로는 안 된다고..? 우선 좀 더 찾아보기로 한다.

 

여기서 자신의 버전에 맞는 whl 파일을 다운받아야 한다는 것도 찾았다. 몇 블로그에서 공유해주신 whl 파일 주소가 있었는데 거긴 window 뿐이라 내게 필요한 macOS 파일을 찾던 중 pypi의 wordcloud doc을 찾았다.

아래를 클릭해 접속한 후 각자 OS와 파이썬 버전에 맞는 파일을 다운로드받자.

 

반응형

 

https://pypi.org/project/wordcloud/#files

wordcloud

어떤 파일을 다운로드받아야하는가? 구글링을 하다가 아래 내용을 찾았다.

우리가 봐야 하는 파이썬 버전은 cp이고, 확인해보니 cp10까지밖에 없는 것으로 보인다.. 즉 파이썬 버전 3.10 이 필요하다.

• py: Generic Python (does not require implementation-specific features)
• cp: CPython
• ip: IronPython
• pp: PyPy
• jy: Jython

그래서 가상환경을 설치해서 python 3.10을 설치해서 진행해보기로 했다.

 

맥에 가상환경을 설치하는 방법으로 유명한 건 virtualenv 라는 외부 패키지였다. 하지만 그건 파이썬 2였고, 파이썬 3.3 부터는 venv 모듈이 내장되기 때문에 별도 패키지 설치없이 파이썬만 설치되어 있으면 바로 가상 환경 구성이 가능하다.

 

우선 Pc에서 가상환경을 구성할 프로젝트 디렉터리로 접속해서 iterm을 켜고 아래와 같이 가상환경 설치, 실행 및 파이썬 버전 확인을 진행했다.(이 과정은 샘플, 하단에서 다시 수행)

python3 -m venv .venv #파이썬3 가상환경 설치
. .venv/bin/activate #가상환경 실행(종료는 deactivate)
python -V #파이썬 버전 확인

이렇게 바로 실행했을 때는 내 pc의 버전인 3.11로 떴다.

which python

이라는 명령어를 입력하면, 우리가 실행한 폴더에서 python을 사용하고 있음을 확인할 수 있다.

 

 

파이썬 홈페이지에서 3.10.10 Version을 내려받아줬다.

다시 원하는 경로에서 iterm을 켜고, 아래와 같이 버전명이 들어간 가상환경을 새로 만들어줬다.

python3.10 -m venv venv310#3.10버전 파이썬 생성
. venv310/bin/activate #활성화
python -V #파이썬 버전 확인 : 3.10.10임을 확인 가능하다.

이제 이렇게 활성화된 가상환경에서 jupyter lab에 접속해서 파일을 새로 만들어주었다.

그리고 아까의 wordcloud 파일 페이지에서 macos whl 파일을 다운받았다.

위치는 가상환경을 만들었던 그 프로젝트 폴더로 이동시킨다.

노트북 셀에서 아래 명령어를 실행해서 파일 다운받기!

%pip install wordcloud-1.8.2.2-cp310-cp310-macosx_10_9_x86_64.whl

 

결과는..

ERROR: wordcloud-1.8.2.2-cp310-cp310-macosx_10_9_x86_64.whl is not a supported wheel on this platform.

 

아예 지원되지 않는 wheel 파일이라고 한다.

맥 초보인 나는.. 원인이 바로 나는 M2 실리콘칩을 사용하고 있기 때문이며, 해당 파일은 인텔칩에만 지원된다는 것을 배우게 되었다.

하지만 M2를 위한 whl파일은 없다.

M2 맥북프로를 선택한 대가라고 생각하면서 방법을 찾던 중, 감사하게도 같이 공부하던 실리콘칩 동료에게 아나콘다의 가상환경을 통해 수행했고 wordcloud가 잘 돌아갔다는 소식을 들었다.

 

그리고 homebrew를 통해 설치한 파이썬과 충돌이 날 수도 있다는 소식을 구글링을 통해 접했다.

homebrew에서 uninstall을 거쳐 파이썬을 모두 삭제하고, anaconda를 통해 다시 설치해서 해결해보려고 한다!