mushroom

Project on SemEval-2025 Task-3 - Mu-SHROOM, the Multilingual Shared-task on Hallucinations and Related Observable Overgeneration Mistakes

Installation

Install uv

curl -Ls https://astral.sh/uv/install.sh | sh

Install dependencies

uv sync

Execution

Download data

uv run src/mushroom/utils/download_data.py

Run pipeline

uv run src/mushroom/pipeline/pipeline.py

Project Structure

• src/
  • mushroom/
    • config/
      • config.py - Configuration settings using Pydantic
    • participant_kit/
    • pipeline/
      • data_connector.py - Data reading and writing utilities
      • interface.py - Entry interface
      • pipeline.py - Main pipeline implementation
      • fact_extractor/
      • retrieval/
      • span_labeling/
        • evaluate_span_labeling.py - Evaluation script for span labeling
        • span_labeling.py - Span labeling implementation
    • utils/
      • download_data.py - Script to download datasets