A CLI-based learning tool with Fisher-Yates shuffling and SuperMemo 2 — built to help me (and maybe you) study smarter, not harder.
🧠 Why I Built StudyQuiz
Flashcards helped me memorize, but they didn't help with deep understanding.
I tried Anki, Quizlet, even Python scripts but nothing clicked.
What I needed was:
- Multiple-choice quizzes per chapter, not per flashcard.
- A learning algorithm like SuperMemo 2 for spaced repetition.
- A fast, testable backend I could expand over time.
So I built StudyQuiz.
🔧 Tech Stack
- 🐍 Python
- ⚡ FastAPI + Async SQLAlchemy
- 🐘 PostgreSQL
- 🧪 Pytest + test DB reset fixture
- 💡 CLI-based quiz attempts for now (browser UI coming soon)
✅ What’s in v0.1.0
- ✅ Batch creation of:
- Users
- Modules
- Quizzes
- Questions + Answers (nested JSON)
- ✅ Fisher-Yates question shuffling
- ✅ SuperMemo 2 spaced repetition
- ✅ Quiz attempts that:
- Record scores
- Schedule follow-ups
- Run in the terminal
- ✅ Fully tested core
🖥️ How to Run
1) Clone the repo
2) Install dependencies
3) Run the app:
uvicorn app.main:app --reload
4) Use Swagger UI:
Visit http://127.0.0.1:8000/docs
🎮 The quiz runs interactively in your terminal after the POST is triggered.
🧭 Next: A Guide for CLI + Leveraging ChatGPT for Batch Queries
Before building the UI, I’ll publish a step-by-step guide on:
🖥️ How to use StudyQuiz from the terminal
🧠 How to leverage ChatGPT to:
Generate quiz questions and answers in batch
Summarize slides and course material
Study smarter, faster, and with deeper understanding
🎯 The goal: help early adopters get real value before the full frontend arrives
🔜 What’s Coming in v0.2.0
- 🌐 Full browser UI with Svelte + TailwindCSS
- 🧪 More test coverage (attempts, followups)
⭐ Try It + Feedback
Here’s the repo:
🔗 github.com/aissa-laribi/studyquiz
- Star it ⭐ if you like it
- Raise issues 💬 if something breaks
💬 Let’s Connect
Ask me questions here or find me on GitHub
Thanks for reading 🙏
Top comments (0)