gygy-open/question-bank — explained in plain English
Analysis updated 2026-05-18
Upload a Word document, Markdown file, or scanned image and let AI extract structured exam questions automatically.
Organize a large question library by subject and knowledge point using vector search plus AI reranking.
Run questions through a draft-to-published review workflow with audit logging before they go live.
Assemble a custom test paper by filtering questions and exporting a collected basket.
| gygy-open/question-bank | w512/texodus | u6u83wu7-hub/inflation-vue | |
|---|---|---|---|
| Stars | 29 | 25 | 24 |
| Language | Vue | Vue | Vue |
| Setup difficulty | moderate | moderate | easy |
| Complexity | 4/5 | 2/5 | 1/5 |
| Audience | developer | general | general |
Figures from each repo's GitHub metadata at analysis time.
Requires Docker Compose to run MySQL, ChromaDB, backend, worker, and frontend together, plus an API key for a supported AI provider.
Question Bank is a system for building and managing a library of exam or quiz questions, built with AI baked into its core workflow rather than added as an afterthought. It is aimed at educators or organizations that need to collect, organize, and reuse test questions at scale. The standout feature is smart importing: a user can upload a Word document, a Markdown file, or even an image of a printed test, and the system uses AI to automatically pull out structured questions from it, including multiple choice, multiple answer, fill in the blank with support for more than one correct answer, true or false, and open ended questions, along with rich text and math formulas. Imported questions go through a review workflow of draft, pending review, published, and archived, with a full audit log and support for soft deletes and bulk actions. The system also organizes questions by knowledge point using a technique called RAG, retrieval augmented generation, where a vector database called ChromaDB finds candidate topics related to a question and then a batch reranking step maps those candidates back to a standard set of subject knowledge points. It supports multiple AI providers, including Google Gemini, OpenAI, and any OpenAI compatible API such as DeepSeek or a privately hosted model, and these can be swapped without restarting the service since the configuration lives in the database. The project also includes an AI chat feature that supports images, exam assembly from filtered questions into a temporary basket for export, subject and tag management, user roles and permissions, and full activity logging. The frontend is built with Nuxt and Vue, and the backend runs on FastAPI with Python. The whole system can be started with one Docker Compose command that brings up the database, vector store, backend, background worker, and frontend together. It is released under the AGPL-3.0-or-later license.
An AI-native question bank system that imports questions from Word, Markdown, or images, organizes them by knowledge point using RAG, and manages them through a review-and-publish workflow.
Mainly Vue. The stack also includes Vue, Nuxt, FastAPI.
AGPL-3.0: you can use and modify it freely, but if you run a modified version as a network service, you must also share your source code changes.
Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.