Version: v1.6.1
Released: October 10, 2025
Status: Production Ready
Latest Release: Download v1.6.1
EMSTrainer is an AI-powered EMS training system with three modes: Scenario Practice, Test Questions, and Study Guides. Designed for both students and instructors, it provides realistic training scenarios with automatic grading and detailed feedback.
- 👨🎓 Student Side: Practice scenarios, generate study materials, receive immediate feedback
- 👨🏫 Instructor Side: Create scenarios, generate tests/study guides, deploy to students, auto-grade submissions
EMSTrainer requires GPT-5 for medical accuracy and clinical reasoning.
- Available in: Microsoft Copilot (free tier) or ChatGPT Plus
- How to enable: Open settings in Copilot/ChatGPT and manually enable GPT-5
- DO NOT use: GPT-4 or earlier models (insufficient medical knowledge)
- Best: Laptop or desktop computer
- Mobile: Bluetooth keyboard strongly recommended
- Voice input: Works but less precise for medical terminology
- Download: Student Package v1.6.1
- Enable GPT-5 in Copilot or ChatGPT
- Load prompts: Drag and drop files into your AI assistant
- Start practicing: Choose your mode and difficulty
- Get feedback: Receive detailed performance analysis
📖 See Student Quick Start Guide for detailed instructions.
- Download: Instructor Package v1.6.1
- Load prompts: Drag files into GPT-5
- Create content: Scenarios, tests, and study guides via natural conversation
- Deploy to students: Email templates provided
- Auto-grade: Paste student submissions for instant feedback and class summaries
📖 See Instructor Quick Start Guide and Instructor Reference Guide.
- Monica-level mega-code (60-minute cascading emergency)
- Multi-system patient complexity
- Equipment realism and failures
- 1000-point grading rubric
- Step-by-step test export instructions
- Upload test results for personalized training
- Focus on weak areas automatically
- PDF generation using pure Python (reportlab)
- Temporary chat mode recommendations
- Enhanced equipment tracking in scenarios
- Continue.dev workflow rules for contributors
- Split into Core, Scenario Mode, and Instructor prompts
- No more character limits (drag-and-drop files)
- Easier maintenance and updates
- Easy: Learning-focused, hints provided, no penalties
- Standard: NREMT-level, realistic timing, balanced support
- Hard: Strict timing, equipment failures (20-25%), minimal hints
- Monica: Extreme difficulty (30-35% failures), hard fail on timeout
- Create custom scenarios via conversation
- Generate test questions on any topic
- Create study guides for students
- Auto-grade submissions with detailed feedback
- Generate class performance summaries
- Practice realistic scenarios
- Generate targeted study materials
- Upload test results for personalized practice questions
- Receive comprehensive performance debriefs
- Not a one-time check
- Scenarios can start unsafe (require staging)
- Dynamic degradation during care
- Hidden grading criteria (15 points)
- IV failures, monitor issues, O2 problems, airway challenges
- Realistic probability scaling by difficulty (0% → 35%)
- Students must adapt and use backup options
🔒 Hidden Grading
- 5 Rights medication check (10 pts)
- AIDET communication (10 pts)
- Scene safety reassessment (15 pts)
- Students discover through debriefs
- Air Care Paramedic support
- Advanced airway, vent management, critical care meds
- Helicopter operations context
- 100% validated with 30-student stress test
- Perfect grade distribution (8A, 4B, 5C, 13D)
- Regression baseline established
- All data integrity checks passed
📖 See WHATS_NEW_v1.6.0.md for complete details.
EMSTrainer/
├── prompts/ # AI prompt files
│ ├── EMSTrainer_Core.txt Foundation + Test/Study
│ ├── EMSTrainer_Student_Interface.txt Student interface
│ └── EMSTrainer_Instructor_Interface.txt Instructor interface
├── deployment/ # Release packages
│ ├── instructor_package_v1.6.1/
│ └── student_package_v1.6.1/
├── docs/ # Documentation
│ ├── Student_Quick_Start_Guide.md
│ ├── Instructor_Quick_Start_Guide.md
│ ├── Instructor_Reference_Guide.md
│ └── WHATS_NEW_v1.6.0.md
├── examples/ # Sample scenarios
│ ├── scenario_cardiac_arrest_vf.json
│ └── scenario_mvc_trauma_monica.json
├── assets/scenarios/ # Advanced scenarios
│ ├── code_blackout_scenario.json # Monica-level mega-code
│ └── code_blackout_grading_rubric.json # 1000-point rubric
├── tests/ # Testing & validation
│ ├── baseline/ # Regression baseline
│ └── results/ # Test reports
├── scripts/ # Automation tools
└── planning/ # Features & roadmap
Create assets/provider_levels.json to override default scope by jurisdiction:
{
"EMT": {
"can_perform": ["IV", "IO", "12-lead", "limited_medications"],
"cannot_perform": ["advanced_airway", "RSI"]
}
}See examples/provider_levels_expanded_emt.json for a complete example.
Run validation scripts to check test data integrity:
python3 scripts/validate_test_results.pyThe v1.6.1 release includes a 30-student stress test baseline in tests/baseline/.
See tests/TEST_PLAN.md and tests/README_TESTING_FRAMEWORK.md for details.
- Student Quick Start Guide - Get started as a student
- Instructor Quick Start Guide - Set up as an instructor
- Instructor Reference Guide - Command reference
- What's New v1.6.0 - Release highlights
- CHANGELOG - Version history
- CONTRIBUTING - Contribution guidelines
Latest: v1.6.1 - October 10, 2025
All documentation also available as PDFs in the release.
- Equipment timing delays (LUCAS 30-45s, EtCO₂ 15s calibration)
- Scenario encryption (AES-256 with digital signatures)
- In-prompt scenario editor
- Enhanced reporting and analytics
- First responders multi-agency scenarios (Fire/Police/FR)
- Instructor test/study generator
Copyright © 2025 Joel Jameson
Licensed under GNU Affero General Public License v3.0 with Commons Clause
✅ Individual students (personal study)
✅ Individual instructors (teaching)
✅ Non-commercial educational use
❌ Commercial SaaS platforms
❌ For-profit training companies
❌ Selling access as a service
For commercial licensing: GitHub Issues (tag: [LICENSING])
See LICENSE for complete terms.
Contributions welcome! Please see CONTRIBUTING.md for guidelines.
- Documentation: See guides in
docs/directory - Issues: GitHub Issues
- Discussions: GitHub Discussions
Last Updated: October 10, 2025