README.md

metadata

title: World Cup Storyteller
emoji: ⚽
colorFrom: green
colorTo: yellow
sdk: gradio
sdk_version: 6.12.0
app_file: app.py
pinned: false
license: mit

⚽ World Cup Storyteller

An interactive NLP app that generates vivid, narrative-driven stories about FIFA World Cup editions and team journeys — built for NLP Homework 4 (ARI 525).

What it does

Pick a World Cup year, a team, write a free-form prompt (or leave it blank), and choose one of three NLP approaches to generate a story:

• Zero-Shot — Raw match data + instruction, no examples
• Few-Shot — Guided by hand-crafted story examples baked into the prompt
• RAG — Retrieves the most relevant context from an embedded knowledge base before generating

Data

FIFA World Cup dataset (1930–2014) from Kaggle — covers all matches, scores, teams, and edition summaries.

Stack

• 🦙 Llama 3 8B via Groq API (LLM backbone)
• 🔍 all-MiniLM-L6-v2 (sentence-transformers) for RAG embeddings
• 📦 FAISS for vector similarity search
• 🎛️ Gradio for the UI