kehanlu/Speech-IFEval

Leaderboard and code for "Speech-IFEval", Interspeech 2025

25

stars

28

commits

Python

primary language

May 27, 2025

updated

arxiv.org/abs/2505.19037

README

Speech-IFEval: Evaluating Instruction-Following and Quantifying Catastrophic Forgetting in Speech-Aware Language Models

  • Ke-Han Lu, Chun-Yi Kuan and Hung-yi Lee
  • National Taiwan University
  • Accepted to Interspeech 2025

  • ⁉️ Most speech-aware language models (SLMs) are built from an instruction-tuned LLM, but we found they cannot follow even simple output constraints!
  • 🤔 The catastrophic forgetting problem is often observed in SLM development, but we don't have an evaluation metric to measure it!

🏆 Leaderboard

RankModelClosed-ended (%)Creative Writing (%)CoT (%)IFrate (%)Δ (Forgetting Rate)
SLMs
1DeSTA283.7191.7591.5089.23-3.57
2DiVA83.1461.7583.5076.13-17.73
3BLSP-emo66.3563.7550.5060.20-17.92
4Qwen2-Audio-Instruct41.5967.7532.0047.11
5SALMONN37.4161.2512.0036.89-50.20
6Qwen-Audio-Chat10.9356.0032.0032.98
7LTU-AS28.8347.7511.0029.19-54.90
Reference systems (cascade)
Llama3.1-8B-Instruct88.3293.7598.5093.52
Llama3-8B-Instruct93.3593.7590.5092.53
Llama2-7B-Chat62.2771.0092.5075.26
Qwen2.5-7B-Instruct95.7183.2571.0088.49
Qwen2-7B-Instruct95.8286.0067.5083.11
Qwen-7B-chat62.2775.2582.5073.34
Vicuna 13B v1.172.4578.2571.5074.07
Vicuna 7B v1.152.2078.0064.0064.73

Note: IFrate is the average of Closed-ended, Creative Writing, and CoT following rates.
Forgetting Rate (Δ) is computed relative to each model’s original text-only LLM.

Qwen-audio series use Qwen-7B as their backbone, which is not instruction-tuned. Therefore, no reference system is available for Δ calculation.

📬 If you have evaluated your model using Speech-IFEval, feel free to send your results to us. Once verified, we will update the leaderboard to include your entry!


📊 Evaluate your model

🔧 Setup

git clone https://github.com/kehanlu/Speech-IFEval.git
cd Speech-IFEval
pip install -r requirements.txt

📥 Download Audio Files

cd data
wget https://huggingface.co/datasets/kehanlu/Speech-IFEval/resolve/main/audios.tar
tar -xvf audios.tar

Directory structure:

data/
│── eval_data/
│   │── closed_ended_questions.jsonl             # Closed-ended tasks
│   │── creative_writing.jsonl                   # Creative writing tasks
│   │── chain-of-thought.jsonl                   # CoT reasoning tasks
│   │── closed_ended_questions-woprompt.jsonl    # Baseline version of closed-ended tasks (optional)
│
│── audios/
│   │── Automatic_speech_recognition/
│   │── Gender_recognition/
│   │── Speech_emotion_recognition/
│   │── MMAU/

1. Evaluate Instruction-Following Rate (IFrate)

Run your Speech-aware Language Model (SLM) evaluation (e.g., DeSTA2):

python examples/eval_desta2.py --data /lab/Speech-IFEval/data --output_dir outputs

Then compute IFrate with:

# Closed-ended and Creative Writing evaluation
python -m instruction_following_eval.evaluation_main -i outputs/DeSTA-ntu--DeSTA2-8B-beta/closed_ended_questions.jsonl
python -m instruction_following_eval.evaluation_main -i outputs/DeSTA-ntu--DeSTA2-8B-beta/creative_writing.jsonl

# Chain-of-Thought (CoT) reasoning evaluation
python script/llm_evaluation.py -i outputs/DeSTA-ntu--DeSTA2-8B-beta/chain-of-thought.jsonl --stage 0

Example Results (DeSTA2):

TaskFollowing Rate
Closed-ended83.71%
Creative Writing91.75%
Chain-of-Thought91.50%
IFrate89.23%

2. Evaluate Forgetting Rate (Δ)

With a reference system, we can assess the forgetting rate by comparing the speech-aware model to its text-only counterpart, thereby quantifying the degradation introduced by speech-text training.

Run the reference system baseline (e.g., Llama3-8B-Instruct for DeSTA2):

python examples/eval_llama3_8B_instruct.py --data /lab/Speech-IFEval/data --output_dir outputs

Reference System Results:

TaskFollowing Rate
Closed-ended93.35%
Creative Writing93.75%
Chain-of-Thought90.50%
IFrate92.53%

Calculate Forgetting Rate (Δ)

$$ Δ = (IFrate_{SLM} - IFrate_{Ref}) / (IFrate_{Ref}) = (89.23 - 92.53) / (92.53) = -3.57 $$

ModelIFrateΔ (Forgetting Rate)
Llama3-8B-Instruct92.53%--
DeSTA289.23%-3.57%

📌 (Optional) Task-Level Evaluation

To replicate Table 4 from the paper (with and without output constraints):

# Without constraint prompt (baseline task-level performance)
python script/llm_evaluation.py -i outputs/DeSTA-ntu--DeSTA2-8B-beta/closed_ended_questions-woprompt.jsonl --stage 0

# With constraint prompt
python script/llm_evaluation.py -i outputs/DeSTA-ntu--DeSTA2-8B-beta/closed_ended_questions.jsonl --stage 0

Citation

@article{lu2025speechifeval,
      title={Speech-IFEval: Evaluating Instruction-Following and Quantifying Catastrophic Forgetting in Speech-Aware Language Models}, 
      author={Ke-Han Lu, Chun-Yi Kuan and Hung-yi Lee},
      year={2025},
      eprint={2505.19037},
      archivePrefix={arXiv},
      primaryClass={eess.AS},
      url={https://arxiv.org/abs/2505.19037}, 
}

Contributors

kehanlu

28 commits

kehanlu/Speech-IFEval

Leaderboard and code for "Speech-IFEval", Interspeech 2025

25

stars

28

commits

Python

primary language

May 27, 2025

updated

arxiv.org/abs/2505.19037

README

Speech-IFEval: Evaluating Instruction-Following and Quantifying Catastrophic Forgetting in Speech-Aware Language Models

  • Ke-Han Lu, Chun-Yi Kuan and Hung-yi Lee
  • National Taiwan University
  • Accepted to Interspeech 2025

  • ⁉️ Most speech-aware language models (SLMs) are built from an instruction-tuned LLM, but we found they cannot follow even simple output constraints!
  • 🤔 The catastrophic forgetting problem is often observed in SLM development, but we don't have an evaluation metric to measure it!

🏆 Leaderboard

RankModelClosed-ended (%)Creative Writing (%)CoT (%)IFrate (%)Δ (Forgetting Rate)
SLMs
1DeSTA283.7191.7591.5089.23-3.57
2DiVA83.1461.7583.5076.13-17.73
3BLSP-emo66.3563.7550.5060.20-17.92
4Qwen2-Audio-Instruct41.5967.7532.0047.11
5SALMONN37.4161.2512.0036.89-50.20
6Qwen-Audio-Chat10.9356.0032.0032.98
7LTU-AS28.8347.7511.0029.19-54.90
Reference systems (cascade)
Llama3.1-8B-Instruct88.3293.7598.5093.52
Llama3-8B-Instruct93.3593.7590.5092.53
Llama2-7B-Chat62.2771.0092.5075.26
Qwen2.5-7B-Instruct95.7183.2571.0088.49
Qwen2-7B-Instruct95.8286.0067.5083.11
Qwen-7B-chat62.2775.2582.5073.34
Vicuna 13B v1.172.4578.2571.5074.07
Vicuna 7B v1.152.2078.0064.0064.73

Note: IFrate is the average of Closed-ended, Creative Writing, and CoT following rates.
Forgetting Rate (Δ) is computed relative to each model’s original text-only LLM.

Qwen-audio series use Qwen-7B as their backbone, which is not instruction-tuned. Therefore, no reference system is available for Δ calculation.

📬 If you have evaluated your model using Speech-IFEval, feel free to send your results to us. Once verified, we will update the leaderboard to include your entry!


📊 Evaluate your model

🔧 Setup

git clone https://github.com/kehanlu/Speech-IFEval.git
cd Speech-IFEval
pip install -r requirements.txt

📥 Download Audio Files

cd data
wget https://huggingface.co/datasets/kehanlu/Speech-IFEval/resolve/main/audios.tar
tar -xvf audios.tar

Directory structure:

data/
│── eval_data/
│   │── closed_ended_questions.jsonl             # Closed-ended tasks
│   │── creative_writing.jsonl                   # Creative writing tasks
│   │── chain-of-thought.jsonl                   # CoT reasoning tasks
│   │── closed_ended_questions-woprompt.jsonl    # Baseline version of closed-ended tasks (optional)
│
│── audios/
│   │── Automatic_speech_recognition/
│   │── Gender_recognition/
│   │── Speech_emotion_recognition/
│   │── MMAU/

1. Evaluate Instruction-Following Rate (IFrate)

Run your Speech-aware Language Model (SLM) evaluation (e.g., DeSTA2):

python examples/eval_desta2.py --data /lab/Speech-IFEval/data --output_dir outputs

Then compute IFrate with:

# Closed-ended and Creative Writing evaluation
python -m instruction_following_eval.evaluation_main -i outputs/DeSTA-ntu--DeSTA2-8B-beta/closed_ended_questions.jsonl
python -m instruction_following_eval.evaluation_main -i outputs/DeSTA-ntu--DeSTA2-8B-beta/creative_writing.jsonl

# Chain-of-Thought (CoT) reasoning evaluation
python script/llm_evaluation.py -i outputs/DeSTA-ntu--DeSTA2-8B-beta/chain-of-thought.jsonl --stage 0

Example Results (DeSTA2):

TaskFollowing Rate
Closed-ended83.71%
Creative Writing91.75%
Chain-of-Thought91.50%
IFrate89.23%

2. Evaluate Forgetting Rate (Δ)

With a reference system, we can assess the forgetting rate by comparing the speech-aware model to its text-only counterpart, thereby quantifying the degradation introduced by speech-text training.

Run the reference system baseline (e.g., Llama3-8B-Instruct for DeSTA2):

python examples/eval_llama3_8B_instruct.py --data /lab/Speech-IFEval/data --output_dir outputs

Reference System Results:

TaskFollowing Rate
Closed-ended93.35%
Creative Writing93.75%
Chain-of-Thought90.50%
IFrate92.53%

Calculate Forgetting Rate (Δ)

$$ Δ = (IFrate_{SLM} - IFrate_{Ref}) / (IFrate_{Ref}) = (89.23 - 92.53) / (92.53) = -3.57 $$

ModelIFrateΔ (Forgetting Rate)
Llama3-8B-Instruct92.53%--
DeSTA289.23%-3.57%

📌 (Optional) Task-Level Evaluation

To replicate Table 4 from the paper (with and without output constraints):

# Without constraint prompt (baseline task-level performance)
python script/llm_evaluation.py -i outputs/DeSTA-ntu--DeSTA2-8B-beta/closed_ended_questions-woprompt.jsonl --stage 0

# With constraint prompt
python script/llm_evaluation.py -i outputs/DeSTA-ntu--DeSTA2-8B-beta/closed_ended_questions.jsonl --stage 0

Citation

@article{lu2025speechifeval,
      title={Speech-IFEval: Evaluating Instruction-Following and Quantifying Catastrophic Forgetting in Speech-Aware Language Models}, 
      author={Ke-Han Lu, Chun-Yi Kuan and Hung-yi Lee},
      year={2025},
      eprint={2505.19037},
      archivePrefix={arXiv},
      primaryClass={eess.AS},
      url={https://arxiv.org/abs/2505.19037}, 
}

Contributors

kehanlu

28 commits

Languages

Python

99.4%