✨ spark is an open-source AI-powered quiz generator that allows users to create custom quizzes on any topic. Built with Next.js and TailwindCSS.
I plan to keep Spark simple and easy to use. Here are some of the features that Spark offers right now:
- 🧠 Generate quizzes on any topic
- 🎚️ Choose difficulty levels: Easy, Medium, Hard
- 🔢 Select the number of questions
- 📖 Get detailed explanations for each question
To run this project locally, follow these steps:
- Clone the repository:
git clone [email protected]:mxvsh/spark.git- Install the dependencies:
bun install # or npm install- Create a
.env.localfile in the root directory and add the following environment variables:
PROVIDER: The AI provider you want to use (ollama or openai)MODEL: The model you want to use (eg. gpt-4o-mini or mistral:7b)OPENAI_API_KEY: Your OpenAI API key (required if you choose openai as the provider)
- Start the development server:
bun dev # or npm run devAlthough Spark is fully functional, there are a few features that I would like to add in the future:
- Add support for timer
- Save user progress
- Daily quizzes
- Add support for code-based questions
If you have any ideas on how to improve Spark, feel free to open an issue or submit a pull request. I would love to hear your feedback!