deepko (한글 머신러닝 도커)

deepko는 머신러닝·딥러닝 실습 환경을 한국어 사용자 기준으로 미리 맞춰둔 도커 이미지입니다. PyTorch·TensorFlow에 한글 폰트와 한국어 자연어처리 패키지를 함께 넣었습니다. GitHub 71스타.

왜 한글 폰트가 도커에 들어가나

matplotlib으로 그래프를 그리면 한글이 네모(□□□)로 깨집니다. 리눅스 컨테이너에 한글 폰트가 없기 때문입니다. 한국에서 ML을 배우는 사람이라면 거의 모두 한 번은 이걸로 시간을 씁니다. deepko는 그 시간을 0으로 만드는 것이 목적입니다.

환경 세팅을 자산화한 사례

코드가 아니라 “돌아가는 환경”을 공유하는 저장소입니다. 강의·스터디에서 “일단 이거 받아서 시작하세요”가 가능해집니다. 가르치는 사람이 겪은 반복을 도구로 만든 형태입니다.

한국에서 ML 환경을 맞출 때 걸리는 것들

• 한글 폰트 부재 → matplotlib 그래프가 □□□로 깨짐
• 로케일 설정 → 한글 파일명·CSV 인코딩(EUC-KR) 오류
• 한국어 NLP 패키지 → KoNLPy는 Java(JDK)까지 필요해 설치가 자주 실패
• CUDA·드라이버 버전 조합

앞의 셋은 한국어 데이터를 다루기 때문에 생기는 문제입니다. 해외 튜토리얼에는 안 나오고, 그래서 각자 처음부터 겪습니다.

같은 결의 한국 개발 환경·학습 자산

• 가루(garu) · Kiwi: 한국어 형태소 분석
• py-hanspell: 맞춤법 검사
• 공공데이터 분석(OpenDataWrangling): 한국 데이터 전처리 실습
• 한국어 STT 벤치마크

이런 분께 맞아요

• 한글 데이터로 ML 실습하는 학습자
• 그래프 한글 깨짐으로 시간을 쓴 적 있는 사람
• 스터디·강의 환경을 통일하려는 운영자
• 재현 가능한 실험 환경이 필요한 연구자