reiqr

reiqr / shiroha-quiz

Public

支持自定义题库导入、练习刷题、模拟考试与错题复习的轻量级刷题应用(现已支持AI核对、AI解析)

18
3
89% credibility
Found May 17, 2026 at 19 stars 2x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

Shiroha Quiz is an open-source study tool that transforms scattered question banks into an interactive learning experience. You can import questions from Word documents, Excel files, PDFs, or plain text — the tool automatically recognizes question types, options, and answers. Once imported, you can practice with instant feedback, take timed exams, or review your mistakes in a dedicated wrong answer book. The app tracks your progress over time and lets you backup all your data. It works on the web, and also as a mobile app for Android with a polished interface and optional AI-powered question checking.

How It Works

1
💡 You discover a study tool

You hear about Shiroha Quiz from a friend or online — a tool that can turn your scattered study materials into an interactive practice app.

2
📄 You import your question bank

You upload your Word document, Excel file, or even a plain text file. The tool automatically recognizes question numbers, options, and answers.

3
You preview and correct the questions

The system shows you a preview of all imported questions. You can fix any mistakes, adjust question types, and make sure everything looks right.

4
🎯 You choose how to study

You can practice questions one by one with instant feedback, or take timed exams like a real test. The choice is yours!

5
Two paths to learning
📝
Practice Mode

Answer questions and get instant feedback. Wrong answers are saved automatically for later review.

⏱️
Exam Mode

Take a timed test with a countdown timer. See your score and detailed results when you finish.

6
📚 Your wrong answers become a study guide

Every question you get wrong is saved to your personal wrong answer book. You can review these anytime and mark them as mastered once you get them right.

🎉 You track your progress and master the material

Your study records show how you're improving over time. With regular practice, you build confidence and eventually master all the questions.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 18 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is shiroha-quiz?

Shiroha Quiz is a lightweight study app built in JavaScript and Kotlin that lets you import question banks from messy formats like Word docs, Excel files, or plain text, then practice, take mock exams, and review mistakes. It solves the real problem of having a disorganized question bank sitting on your hard drive that you cannot actually use for studying. The project ships three versions: a web app, an Android WebView shell for offline use, and a native Android version with AI features and dark mode.

Why is it gaining traction?

The standout feature is the flexible import pipeline. You upload a docx file with questions and answers mixed together, and the system automatically identifies question numbers, options, correct answers, and even handles dual-file imports where questions and answers live in separate documents. The native Android version adds AI-powered verification that checks your imported questions for errors and can generate explanations for each problem. This combination of smart parsing and AI assistance addresses the biggest pain point in study apps: getting your existing content into the system without manual reformatting.

Who should use this?

Students or professionals preparing for certification exams who already have question banks in Word or Excel format and want a self-hosted, offline-capable study tool. Developers who want to contribute to or customize a quiz platform for their team. Anyone frustrated with study apps that require manual question entry or lock you into specific formats.

Verdict

This is a genuinely useful tool with thoughtful import logic that handles real-world messy documents, but the 18 stars and beta status mean it is early-stage and you should verify current stability before relying on it for high-stakes exam preparation. The credibility score of 0.9% reflects the small community, so check the GitHub issues before committing. Worth trying if your workflow involves importing existing question banks.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.