Quizdy is a cross-platform quiz and study app built with Flutter. It combines AI-powered content generation, guided study flows, and exam-ready quiz execution in a single experience across web, mobile, and desktop.
- Web: vicajilau.github.io/quizdy
- Android: Google Play Store
- Huawei: AppGallery
- iOS: App Store
- macOS: Mac App Store
- Windows: Microsoft Store
- Linux: Snapcraft
AI-driven study UI for turning source material into guided reading, contextual explanations, and follow-up question generation.
Practice and exam flows with focused question answering, validation, explanations, timers, and progress tracking.
- Study Mode with an AI-driven interface for exploring content chapter by chapter, asking for explanations, and deepening understanding without leaving the app.
- Practice Mode for immediate validation, feedback, and answer explanations while you work through questions.
- Exam Mode with optional time limits, randomized order, and a cleaner assessment flow.
- AI question generation from text or selected document sections using Gemini or OpenAI.
- Support for multiple question types: multiple choice, single choice, true or false, and essay.
- Cross-platform delivery on Android, iOS, macOS, Windows, Linux, and web.
- Localization in 18 languages.
- Offline quiz execution for non-AI flows.
| Area | Highlights |
|---|---|
| Study | AI study assistant, chapter-based study flow, Markdown and LaTeX support, section-aware generation |
| Quiz | Practice Mode, Exam Mode, scoring, explanations, progress tracking |
| Assessment | Exam timer, question randomization, answer randomization |
| AI | Gemini and OpenAI support, configurable models, service-aware limits |
| Authoring | Create, edit, and customize quiz files with flexible settings |
| Platform | Flutter app for web, mobile, and desktop |
Quizdy includes two complementary AI workflows:
- Generate questions automatically from raw text, topics, or selected sections of a document.
- Use the AI Study Assistant to ask for explanations, context, comparisons, and follow-up help while studying or answering questions.
Supported AI providers:
- Google Gemini
- OpenAI
- Custom / Local AI (Ollama, LM Studio, Groq, etc. to run models like Gemma 4 or Llama 3 via OpenAI-compatible endpoints)
Supported generation formats:
- Multiple choice
- Single choice
- True or false
- Essay
- Mixed generation
- Flutter SDK 3.41.0 or higher
- Dart SDK 3.11.0 or higher
- Android Studio and/or Xcode for mobile development
git clone https://github.com/vicajilau/quizdy.git
cd quizdy
flutter pub get
dart run build_runner build -d
flutter runTo enable AI features, configure at least one provider inside the app's settings:
- Google Gemini: Get an API key from Google AI Studio.
- OpenAI: Get an API key from OpenAI Platform.
- Custom / Local AI (Ollama, LM Studio, Groq, etc.): Run open local models (such as Gemma 4 or Llama 3) or connect to other custom endpoints:
- Base URL: Set the custom endpoint URL (e.g.,
http://localhost:11434/v1for Ollama orhttp://localhost:1234/v1for LM Studio). - API Key: Input your API key if required by the custom provider (otherwise, a dummy key is automatically used).
- Models: Use the Load Models button to dynamically retrieve and register available models from your custom/local endpoint.
- Base URL: Set the custom endpoint URL (e.g.,
flutter analyze
flutter test
flutter build apk
flutter build webContributions are welcome. For substantial changes, run the analyzer and test suite before opening a pull request.
This project is licensed under the GPL-3.0-or-later License. See LICENSE for details.