🍵 차 Cha for Korean

A delightfully refreshing Discord bot for searching and translating Korean.

Korean dictionary bot. Searches National Institute of Korean Language's Korean-English Learners' Dictionary (한국어기초사전), translates Korean using DeepL, and resources including Wiktionary, Google Translate, and romanization.

About

CHA-KO is the Korean Discord bot that delivers language and dictionary information to students, travelers, and kpop/kdrama enthusiasts alike.

Korean, with its unique alphabet, is a fascinating language that draws learners from around the world. However, the journey to fluency can be challenging. Learners often struggle with understanding the language's structure, pronunciation, Hanja, and the cultural nuances inherent to Korean.

CHA-KO is a unified turnkey solution for searching dictionary sources, displaying Hangul Romanization, word definitions/origins, and links to relevant external sources.

CHA-KO uses data from public sources including the National Institute of Korean Language's Korean-English Basic Learners' Dictionary.

Features

• Search dictionary entries in Korean (Hangul, Hanja)
• Search dictionary entries in English
• Pronunciation in Hangul and Romanization
• Word origins in Hanja
• Parts of speech

Commands

This bot uses slash commands.

• /kodict : Searches Korean dictionary
• /kosearch : Searches Korean translation services

This bot also supports a ping as a prefix: @Cha for Korean
For example: @Cha for Korean kodict 신문

Getting Started

Install

Step 1: Download

Clone or download this project.

Step 2: Add your Discord Bot info

Copy .env.example to .env, then:

• Add your bot's token to dpy_token
• Add your bot's User ID to dpy_user_id
• krdict_api_key: Optional
  • https://krdict.korean.go.kr/openApi/openApiInfo
• deepl_api_key: Optional
  • https://www.deepl.com/pro-api

The bot prefix is @ping or Slash command.

Step 3: Run the Bot

Setup a venv using Python >=3.9 and install requirements

python3.9 -m venv ~/dpyenv
source ~/dpyenv/bin/activate
pip install -r requirements.txt

In the future, you can run your bot anytime using

source ~/dpyenv/bin/activate
python3 -m main

Support

Join the Discord >