explaingit

ghandhitechnology/munbench

Analysis updated 2026-07-26

1PythonAudience · researcherComplexity · 3/5Setup · moderate

TLDR

MunBench tests whether AI language models can write naturally in Korean through creative writing, roleplay, and cultural understanding tasks rather than multiple-choice knowledge questions.

Mindmap

mindmap
  root((repo))
    What it does
      Tests Korean writing
      158 native test items
      Three evaluation tracks
    Evaluation tracks
      Roleplay scenarios
      Creative writing prompts
      Cultural understanding tasks
    Scoring methods
      Rubric judge system
      Elo pairwise rating
      Automated cliche detection
    Tech stack
      Python
      OpenRouter API
      Resumable pipeline
    Use cases
      Compare Korean AI models
      Find language weaknesses
      Benchmark cultural fluency

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Compare different AI models on their ability to write natural Korean prose and rank them by Elo rating.

USE CASE 2

Identify specific weaknesses in a model's Korean generation, such as melodramatic writing or fake child voices.

USE CASE 3

Run automated checks for English leaking into Korean text, cliche overuse, and repetition without needing LLM judges.

USE CASE 4

Evaluate a model's cultural fluency through honorific shifts, idiom usage, and reading subtext in conversations.

What is it built with?

PythonOpenRouter API

How does it compare?

ghandhitechnology/munbench0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an OpenRouter API key or direct provider API keys to run model generation and judging.

In plain English

MunBench is a benchmark that tests whether AI language models can write naturally in Korean, not just answer multiple-choice questions about Korean facts. The creators found that existing Korean benchmarks focus on knowledge tests and fail to measure whether a model can actually produce good Korean prose. MunBench fills this gap by evaluating emotional intelligence, creative writing, and cultural understanding through generative tasks. All 158 test items were written natively in Korean, never translated, and were reviewed by critics to ensure each one separates strong models from weak ones. The benchmark has three tracks. The first track presents 50 roleplay scenarios where the model plays a character in emotionally charged, culturally specific situations, like navigating office politics after a team dinner excluded the boss. After the conversation, the model must analyze what the other person was actually feeling. The second track gives 48 creative writing prompts across forms like short fiction, essays, and poetry, targeting known weaknesses like melodramatic overwriting or fake child voices. The third track has 60 tasks testing Korean honorific shifts, idiom usage, cultural defaults, and reading subtext, including trap items that catch models hallucinating emotional undertones that are not present. Scoring works three independent ways. A rubric system uses three judges scoring each criterion on a 0 to 10 scale, three times each, with per-judge disagreement visible in the results. An Elo rating system compares pairs of anonymized outputs head to head, with three anchor models pinned at fixed ratings so adding new models later does not shift existing scores. Judge-free metrics act as tripwires, counting cliches against a curated 184-phrase list, detecting English leaking into Korean text, and measuring repetition and length compliance without relying on any LLM opinions. Running the benchmark requires a single API key routed through OpenRouter, or you can use direct provider APIs instead. The pipeline runs validation, generation, rubric judging, pairwise comparison, Elo fitting, and reporting, with each stage independently resumable if something fails partway through. A full run produces roughly 191 outputs per model. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me set up and run MunBench to evaluate my model's Korean writing ability using OpenRouter, I need to know which API key to get and how to start a full run.
Prompt 2
I ran MunBench and got the results. Walk me through interpreting the rubric judge scores, Elo ratings, and judge-free metrics to understand where my model is weak at Korean.
Prompt 3
I want to add my own Korean creative writing prompt to MunBench's second track. Show me how to format a new test item and add it to the benchmark pipeline.
Prompt 4
Explain how MunBench's three scoring methods work together, rubric judging, Elo comparison, and judge-free tripwires, and which one I should trust most for evaluating Korean prose quality.

Frequently asked questions

What is munbench?

MunBench tests whether AI language models can write naturally in Korean through creative writing, roleplay, and cultural understanding tasks rather than multiple-choice knowledge questions.

What language is munbench written in?

Mainly Python. The stack also includes Python, OpenRouter API.

How hard is munbench to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is munbench for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.