evaluate gated 0 0

davidkim205/ko-ifeval

published by @davidkim205

Alignment dataset tracked in the /datasets sub-catalog.

Lifetime downloads
130
Last 30 days
8
Likes
-
Size
192 KB
Created on HF
2025-07-17
Age
1 years ago

Description

ko-ifeval

Ko-IFEval is a human-verified dataset that translates and adapts IFEval’s English instructions into Korean, reflecting the linguistic and cultural characteristics of the Korean language.

Need for Evaluating Instruction-Following in Korean LLMs

Instruction-following ability is essential for measuring the practical reliability of large language models (LLMs). Accurate execution of user instructions is a core requirement for real-world applications, making quantitative… See the full description on the dataset page: https://huggingface.co/datasets/davidkim205/ko-ifeval.

Tags

language:kosize_categories:n<1Kformat:jsonmodality:textlibrary:datasetslibrary:pandaslibrary:mlcroissantlibrary:polarsregion:us

README current version from Hugging Face


language:

  • ko

ko-ifeval

Ko-IFEval is a human-verified dataset that translates and adapts IFEval’s English instructions into Korean, reflecting the linguistic and cultural characteristics of the Korean language.

Need for Evaluating Instruction-Following in Korean LLMs

  • Instruction-following ability is essential for measuring the practical reliability of large language models (LLMs). Accurate execution of user instructions is a core requirement for real-world applications, making quantitative benchmarks crucial for model evaluation.
  • Existing benchmarks like IFEval are designed for English and are not well-suited for Korean. Linguistic features such as ambiguous sentence boundaries, cultural mismatches in translated content, and the lack of Korean-specific datasets hinder accurate and fair evaluation of Korean LLMs.
  • Ko-IFEval provides a human-verified dataset and an evaluation tool tailored for Korean. By reflecting Korean linguistic and cultural characteristics, it enables more precise and fair assessment of instruction-following performance in Korean LLMs.

Dataset Construction

Ko-IFEval was constructed through the following three steps:

  1. translation of prompts using GPT-4o
  2. removal and modification of conditions incompatible with Korean linguistic structures
  3. adaptation of prompts to reflect Korean cultural context

Removed Categories

We excluded categories relying on English-specific linguistic features or irrelevant for Korean evaluation:

  • English-dependent categories: change_case:capital_word_frequency, change_case:english_capital, change_case:english_lowercase
  • Korean-irrelevant category: language:response_language

Post-translation Adjustments

  • Clarifying word count vs. character count:
    The length_constraints:number_words category was translated to refer to "어절" (space-separated word units in Korean). To support character-based constraints, a separate condition, length_constraints:number_letters, was introduced.

  • Adjusting paragraph and quotation conditions:
    When both length_constraints:nth_paragraph_first_word and startend:quotation conditions co-occur, the paragraph indices were adjusted to avoid logical conflicts.

  • Refining letter frequency constraints:
    In keywords:letter_frequency, thresholds were calibrated to better fit the distribution of characters in Korean. When literal application would cause excessive difficulty, thresholds were adjusted. For example, a prompt requiring a high frequency of the letter "o" was adapted as follows:

    # Original
    Write a letter to your friend who recently moved away. Your entire response should be in English, and in all capital letters. The letter o should appear at least 40 times.
    
    # Modified
    최근 이사 간 친구에게 편지를 써주세요. 글자 '오'를 최소 13번 이상 포함해야 합니다.
    
  • Restricting constraint combinations:
    The combination:repeat_prompt condition enforces that the response must begin with the prompt itself. Therefore, it is only paired with length_constraints:number_sentences, length_constraints:number_words, or length_constraints:number_letters constraints.

  • Adapting to Korean cultural context:
    Unfamiliar names and culturally irrelevant topics in prompts were replaced with localized content.

    # Original
    Write a 300+ word summary of the wikipedia page "https://en.wikipedia.org/wiki/Raymond_III,_Count_of_Tripoli".
    
    # Modified
    위키백과 페이지 "https://ko.wikipedia.org/wiki/이순신"의 내용을 요약하여 300자 이상으로 작성하시오.
    

Structure

The ko-ifeval is based on the structure of the IFEval dataset.

  • key: A unique ID for the prompt.
  • prompt: Describes the task the model should perform.
  • instruction_id_list: An array of verifiable instructions. See Table 1 of the paper for the full set with their descriptions.
  • kwargs: An array of arguments used to specify each verifiable instruction in instruction_id_list.
[
  {
    "id": 1000,
    "prompt": "위키백과 페이지 \"https://ko.wikipedia.org/wiki/이순신\"의 내용을 요약하여 300자 이상으로 작성하시오. 쉼표를 사용하지 말고, 최소 3개의 섹션 제목을 마크다운 형식으로 강조하시오. 예: *강조된 섹션 1*, *강조된 섹션 2*, *강조된 섹션 3*.",
    "instruction_id_list": [
      "punctuation:no_comma",
      "detectable_format:number_highlighted_sections",
      "length_constraints:number_letters"
    ],
    "kwargs": [
      {},
      {
        "num_highlights": 3
      },
      {
        "relation": "at least",
        "num_letters": 300
      }
    ]
  }
]

README history 4 revisions

Every night we snapshot the README of every dataset in the catalog. When the SHA changes we archive the new version and diff it against the last. This is the evolving thought record of the alignment-data field: what the author decided to say about the corpus, and how that framing shifted over time.

  1. 2025-07-17Update README.md804b8be4.7 KB
    Loading...
  2. 2025-07-17Create README.mdaeb42654.3 KB
    Loading...
  3. 2025-07-17Upload ko_ifeval.jsonl10981ac0 B
    Loading...
  4. 2025-07-17initial commitbfad8740 B
    Loading...

Used by abliterated models none yet

No abliterated models in our catalog have declared this dataset in their YAML metadata yet. This can mean the dataset is used but not declared, is used outside abliteration workflows, or is new. The link will populate automatically as models are indexed.

Related datasets same stage · evaluate

Read further

Repository

Download the dataset

Gated dataset. You need to accept the author's terms on Hugging Face before downloading. Visit the repository, click Agree and access repository, then log in locally with huggingface-cli login and use one of the snippets below.

Copy any of these snippets into your notebook or terminal. All three fetch directly from Hugging Face using your own credentials.

Recommended: datasets library (Python)
from datasets import load_dataset
ds = load_dataset("davidkim205/ko-ifeval")
Raw snapshot (Python)
from huggingface_hub import snapshot_download
snapshot_download(repo_id="davidkim205/ko-ifeval", repo_type="dataset")
git clone (requires git-lfs)
git clone https://huggingface.co/datasets/davidkim205/ko-ifeval
Catalog is the map. Apps are the tools.

Run models on your own machine, not in the cloud.

Every model page has an "Open in Abliteration" button that hands the model directly to the first-party desktop client, at the quantization your rig can actually run. No API keys, no subscription, no prompt leakage.

Open in Abliteration