QuizFlash / README_HF.md
Shih-hungg's picture
Update
539f230
metadata
title: QuizFlash - AI-Powered Quiz Generation
emoji: πŸŽ“
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
app_port: 7860

QuizFlash - AI-Powered Quiz Generation

An intelligent quiz creation tool that helps educators generate interactive assessments using AI. Create various types of questions including cloze tests, comprehension questions, and more.

Features

  • πŸ€– AI-powered question generation
  • πŸ“š Multiple question types (Cloze, Word Comprehension, Grammar, etc.)
  • πŸ“„ Source article integration
  • πŸ’¬ Interactive chat interface
  • 🎯 Customizable difficulty levels
  • πŸ“Š Question bank management

How to Use

  1. Select Question Type: Choose from various question formats
  2. Configure Parameters: Set difficulty, grade level, and other options
  3. Add Source Article: Provide text content for question generation
  4. Generate Questions: Let AI create questions based on your specifications
  5. Manage Questions: Edit, reorder, and export your quiz

Environment Variables

Make sure to set your OpenAI API key in the Hugging Face Space settings:

OPENAI_API_KEY=your_openai_api_key_here

Question Types

  • Cloze (Fill-in-the-blank): Test vocabulary and comprehension
  • Word Comprehension: Assess vocabulary understanding in context
  • Grammar Structure: Identify grammatical patterns
  • Paragraph Structure: Analyze text organization
  • Paragraph Summary: Create text summaries
  • Paragraph Details: Identify key information
  • Textual Inference: Make logical inferences from text

Technology Stack

  • Next.js 15 with App Router
  • React 19
  • TypeScript
  • Tailwind CSS
  • OpenAI GPT-4o-mini
  • AI SDK for React