1. 설치 및 초기화 (Install & Initialize)

여기에 수록된 사용법(1~3절)은 모두 1.x 버전의 사용법입니다. 최신 버전의 사용법은 Usage를 참고하십시오.

우선 Java 8 이상을 설치하고, JAVA_HOME을 환경변수에 등록해주십시오. 그런 다음, 아래와 같이 설치하십시오.

$ pip install Cython # Cython은 별도 설치가 필요합니다.
$ pip install koalanlp

각 형태소 분석기는 별도의 패키지로 나뉘어 있습니다.

패키지 API명	한국어 명칭	지원기능
API.HANNANUM	한나눔	문장분리, 품사분석, 의존구문분석
API.KKMA	꼬꼬마	품사분석, 의존구문분석
API.KOMORAN	코모란	품사분석
API.TWITTER	트위터/오픈한글	문장분리, 품사분석
API.EUNJEON	은전한닢	품사분석
API.ARIRANG	아리랑	품사분석
API.RHINO	라이노	품사분석

초기화 과정에서 KoalaNLP는 필요한 Java Library를 자동으로 다운로드하여 설치합니다. 설치에는 시간이 다소 소요됩니다. 때문에, 프로그램 실행시 최초 1회에 한하여 초기화 작업이 필요합니다.

from koalanlp import *

# 꼬꼬마와 은전한닢 분석기의 1.9.1 버전을 참조합니다.
initialize(packages=[API.KKMA, API.EUNJEON], version="1.9.1", java_options="-Xmx4g")