설치하기

주석

For troubleshooting information, see these pages: Linux. Mac OS. Windows. Please record a “New Issue” if you have an error that is not listed.

경고

Python 2 End of Life Announced as January 1st 2020.

This page covers Python 3 only. The last-known version for Python 2 is v0.5.2, install it via pip install konlpy==v0.5.2.

우분투

Supported: Xenial(16.04.3 LTS), Bionic(18.04.3 LTS), Disco(19.04), Eoan(19.10)

  1. Install dependencies

    # Install Java 1.8 or up
    $ sudo apt-get install g++ openjdk-8-jdk python3-dev python3-pip curl
    
  2. Install KoNLPy

    $ python3 -m pip install --upgrade pip
    $ python3 -m pip install konlpy       # Python 3.x
    
  3. MeCab 설치하기 (선택사항)

    $ sudo apt-get install curl git
    $ bash <(curl -s https://raw.githubusercontent.com/konlpy/konlpy/master/scripts/mecab.sh)
    

CentOS

Supported: CentOS 7, 8

  1. Install dependencies

    $ sudo yum install gcc-c++ java-1.8.0-openjdk-devel python3 python3-devel python3-pip make diffutils
    
  2. Install KoNLPy

    $ python3 -m pip install --upgrade pip
    $ python3 -m pip install konlpy     # Python 3.x
    
  3. MeCab 설치하기 (선택사항)

    $ sudo yum install curl git
    $ bash <(curl -s https://raw.githubusercontent.com/konlpy/konlpy/master/scripts/mecab.sh)
    

맥 OS

  1. Install KoNLPy

    $ python3 -m pip install --upgrade pip
    $ python3 -m pip install konlpy        # Python 3.x
    
  2. MeCab 설치하기 (선택사항)

    $ bash <(curl -s https://raw.githubusercontent.com/konlpy/konlpy/master/scripts/mecab.sh)
    

윈도우

  1. 내 시스템에 설치된 파이썬의 “비트 수”가 OS의 비트 수와 일치하는지 확인해주세요. 예를 들어, 64비트 윈도우를 사용하고 있다면 64비트 파이썬이, 32비트 윈도우를 사용하고 있다면 32비트 파이썬이 설치되어 있어야 합니다. 비트 수가 서로 일치하지 않는다면 OS에 맞게 파이썬을 재설치합니다.
    • 윈도우 비트 수 확인하는 법

      ../_images/windows-bits.png
    • 파이썬 비트 수 확인하는 법

      ../_images/python-bits.png
  2. OS와 비트 수가 일치하고, 버젼이 1.7 이상인 자바가 설치되어 있나요? 만일 그렇지 않다면 JDK를 설치 합니다. 자바와 OS의 비트 수가 꼭 일치하도록 해주세요.

  3. JAVA_HOME을 설정 합니다.

  4. OS의 비트 수와 일치하는 JPype1 (>=0.5.7) 를 설치해주세요. 32비트 OS에는 win32, 64비트 OS에는 win-amd64 파일을 사용하면 됩니다. whl 파일로 설치하는 경우에는 다음과 같이 명령프롬프트에서 pip을 업그레이드 해주세요. (명령프롬프트는 Windows + r을 누른 후 실행창에서 cmd를 입력하면 띄울 수 있습니다.)

    > pip install --upgrade pip
    > pip install JPype1-0.5.7-cp27-none-win_amd64.whl
    
  5. 마지막으로, 명령프롬프트에서 KoNLPy를 설치합니다.

    > pip install konlpy
    

경고

  • KoNLPy의 Mecab() 클래스는 윈도우에서 지원되지 않습니다.

도커

If you are familiar with Docker, it is easy to install konlpy and java-1.7-openjdk on python:3 image.

> FROM python:3

> ENV JAVA_HOME /usr/lib/jvm/java-1.7-openjdk/jre
> RUN apt-get update && apt-get install -y g++ default-jdk
> RUN pip install konlpy

> # Write left part as you want