An interactive language learning application that helps users improve their language skills through fill-in-the-blank exercises powered by Groq LLM with real-time NLP analysis.
- Interactive Fill-in-the-Blank Exercises: Practice language skills with dynamically generated questions
- Real-time NLP Analysis: See the part of speech breakdown for each word in completed sentences
- Instant Feedback: Get immediate feedback on your answers
- Progress Tracking: Monitor your score as you play
- Responsive Design: Enjoy a seamless experience on any device
- Beautiful UI: Modern, clean interface with smooth animations
- Frontend: SvelteKit 5 with Runes
- Styling: Tailwind CSS with custom animations
- API Integration: Groq LLM API (llama3-70b-8192 model)
- Animations: Svelte transitions and custom CSS effects
- Node.js 18+ and npm/pnpm/yarn
- Groq API key
-
Clone the repository
git clone https://github.com/rk-vashista/NLP-Project cd NLP-Project
-
Install dependencies
npm install # or pnpm install # or yarn
-
Create a
.env
file in the root directory with your Groq API keyGROQ_API_KEY=your_groq_api_key_here
-
Start the development server
npm run dev # or npm run dev -- --open
- Click "Start Game" on the home screen
- For each question, read the sentence with the blank space
- Choose the correct word from the three options provided
- Submit your answer and see the NLP analysis of the complete sentence
- Continue to the next question
- At the end, review your score and play again
The application integrates with two main API endpoints:
- Generates 5 fill-in-the-blank questions using Groq LLM
- Each question includes a sentence with a blank, three options, and the correct answer
- Analyzes completed sentences to identify parts of speech for each word
- Returns structured data that is visually represented in the UI
- LoadingSpinner: Displays while content is loading
- QuestionCard: Presents questions with interactive option selection
- ProgressBar: Shows current progress through the questions
- Results: Displays final score with appropriate feedback
[Add screenshots of your application here]
Variable | Description |
---|---|
GROQ_API_KEY | Your Groq API key for accessing the LLM services |
This project is licensed under the MIT License - see the LICENSE file for details.
- Groq for providing the LLM API
- SvelteKit for the framework
- Tailwind CSS for styling utilities