Coffee Maubot 🍢 Website
Coffee Maubot 🍢
© 2026, ☕🏛

kodict

A Korean dictionary Matrix bot for searching and translating Korean vocabulary.

Searches National Institute of Korean Language's Korean-English Learners' Dictionary (한국어기초사전).

preview.jpg


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

Setup

See Coffee Maubot: Getting Started to set up your Maubot instance, if you don't have one yet.

Prerequisites are required:

  • Shut down your Maubot, then run:
    • python -m pip install cssselect kodict-core korean-romanizer krdict.py@git+https://github.com/coffeebank/krdict.py lxml
  • Start your Maubot again, then install the .mbp from your Maubot Dashboard website, and add an instance
  • (Optional) In the Config, add your Korean-English Learners' Dictionary (한국어기초사전) API Key under krdict_api
  • Click Save

Config

Commands

  • kodict, aliases=["krdict"]
    • Searches Korean dictionary

Uses material from National Institute of Korean Language's Korean-English Learners' Dictionary (한국어기초사전).

Notes

  • This plugin requires Python 3.9+ (Maubot recommends Python 3.10+)
  • A custom krdict.py dependency is required.
    • The custom version replaces requests with aiohttp, asyncio for async support

Resolved:

  • Krdict API Key Requirement
    • (2024-05-07) A Korean-English Learners' Dictionary (한국어기초사전) API Key (free) is required.
      • krdict.py's non-api URLs needs fixing. No ETA. The API methods still work.
    • (2026-02-28) ✅ Resolved - Please shut down Maubot, then run python -m pip install --upgrade kodict-core korean-romanizer krdict.py@git+https://github.com/coffeebank/krdict.py to update your dependencies, and restart Maubot again.