| | --- |
| | title: NCLEX Practice Question Generator |
| | emoji: 📋 |
| | colorFrom: purple |
| | colorTo: indigo |
| | sdk: streamlit |
| | sdk_version: 1.32.0 |
| | app_file: streamlit_app.py |
| | pinned: false |
| | license: mit |
| | --- |
| | |
| | <div align="center"> |
| |
|
| | # 📋 NCLEX Practice Question Generator |
| |
|
| | **Clinically accurate NCLEX-style questions · Full rationales · Unlimited dosage calculations** |
| |
|
| | [](https://huggingface.co/spaces/NurseCitizenDeveloper/nclex-prep) |
| | [](https://github.com/Clinical-Quality-Artifical-Intelligence/nclex-prep) |
| | [](LICENSE) |
| | [](https://www.ncsbn.org/nclex-rn) |
| |
|
| | *No login · No API key · No cost · Built by a nurse, for nurses* |
| |
|
| | </div> |
| |
|
| | --- |
| |
|
| | ## Overview |
| |
|
| | The **NCLEX Practice Question Generator** provides student nurses with high-quality, evidence-based practice questions aligned to the **2023 NCLEX-RN Test Plan** (NCSBN). Every question includes a detailed clinical rationale — teaching students not just the correct answer, but the critical thinking process behind it. |
| |
|
| | Dosage calculation questions are dynamically generated, providing unlimited unique math practice so students never memorise the same problem twice. |
| |
|
| | --- |
| |
|
| | ## Features |
| |
|
| | ### 🎯 Practice Quiz |
| | - **30+ high-quality questions** across all NCLEX Client Needs categories |
| | - **Multiple Choice (MCQ)** — single best answer format |
| | - **Select All That Apply (SATA)** — the most challenging NCLEX question type |
| | - Filter by **category**, **difficulty**, and **question type** |
| | - Instant answer reveal with detailed **clinical rationale** |
| |
|
| | ### 💉 Dosage Calculations |
| | - **Dynamically generated** — unlimited unique problems, never the same set twice |
| | - Five question types: |
| | - Oral tablet calculations |
| | - IV infusion rate (mL/hr) |
| | - Manual drip rate (gtt/min) |
| | - Weight-based IV infusions (mcg/kg/min) |
| | - Paediatric oral liquid dosing |
| | - Step-by-step solution shown in the rationale |
| |
|
| | ### 📊 Results & Performance Tracking |
| | - Overall score and performance band |
| | - **Category breakdown** — identify weak areas by NCLEX domain |
| | - **Difficulty breakdown** — performance across beginner / intermediate / advanced |
| |
|
| | ### 🔁 Wrong Answer Review |
| | - Every missed question available for focused review |
| | - NCLEX framework category shown for each question |
| | - Rationale emphasised to build clinical reasoning |
| |
|
| | --- |
| |
|
| | ## NCLEX Client Needs Categories Covered |
| |
|
| | | Category | Sub-categories | |
| | |----------|---------------| |
| | | **Safe & Effective Care Environment** | Management of Care · Safety & Infection Control | |
| | | **Health Promotion & Maintenance** | Growth & Development · Preventive Care | |
| | | **Psychosocial Integrity** | Mental Health · Therapeutic Communication | |
| | | **Physiological Integrity** | Basic Care · Pharmacology · Risk Reduction · Physiological Adaptation | |
| |
|
| | --- |
| |
|
| | ## Question Types |
| |
|
| | | Type | Description | NCLEX Relevance | |
| | |------|-------------|-----------------| |
| | | MCQ | Single best answer from 4 options | ~50% of NCLEX-RN | |
| | | SATA | Select all correct options from 5–6 | ~20% of NCLEX-RN | |
| | | Calculation | Dosage math with step-by-step workings | ~10% of NCLEX-RN | |
| |
|
| | --- |
| |
|
| | ## Tech Stack |
| |
|
| | | Layer | Technology | |
| | |-------|-----------| |
| | | Frontend | [Streamlit](https://streamlit.io/) (Python) | |
| | | Question bank | Curated clinical question library (Python data structures) | |
| | | Calc generator | Dynamic random question generation (no LLM required) | |
| | | Hosting | [Hugging Face Spaces](https://huggingface.co/spaces) — free CPU tier | |
| | | CI/CD | GitHub Actions → auto-deploy on push | |
| |
|
| | > **No API keys. No paid services. Fully open-source.** |
| |
|
| | --- |
| |
|
| | ## Local Development |
| |
|
| | ```bash |
| | git clone https://github.com/Clinical-Quality-Artifical-Intelligence/nclex-prep.git |
| | cd nclex-prep |
| | pip install -r requirements.txt |
| | streamlit run streamlit_app.py |
| | ``` |
| |
|
| | Requirements: Python 3.10+ · `streamlit` · `requests` |
| |
|
| | --- |
| |
|
| | ## About — Nursing Citizen Development |
| |
|
| | Part of the **Nursing Citizen Development** initiative — clinicians building the tools their profession needs. |
| |
|
| | **Related tools:** |
| | - [EBP Research Tool](https://huggingface.co/spaces/NurseCitizenDeveloper/nursing-ebp-tool) — PubMed search with nursing summaries & APA citations |
| | - [Drug Card Generator](https://huggingface.co/spaces/NurseCitizenDeveloper/nursing-drug-cards) — Instant FDA drug reference cards |
| |
|
| | --- |
| |
|
| | ## Disclaimer |
| |
|
| | For educational purposes only. Questions are designed to simulate NCLEX-style critical thinking but do not represent actual NCLEX examination items. Always study from NCSBN-approved resources and consult your nursing programme's curriculum. |
| |
|
| | --- |
| |
|
| | ## License |
| |
|
| | [MIT](LICENSE) © Nursing Citizen Development / Clinical Quality Artificial Intelligence |
| |
|
| | --- |
| |
|
| | <div align="center"> |
| | <sub>Built with 🩺 by <a href="https://huggingface.co/NurseCitizenDeveloper">Nursing Citizen Development</a></sub> |
| | </div> |
| |
|
