Welcome to the official user guide for SimpleInsulinCalc, an open-source insulin dose calculator built to help Type 1 diabetes patients estimate bolus doses based on carbohydrate intake and correction needs.
This guide covers usage of both the command-line interface (CLI) and the graphical user interface (GUI).
cd v1.0_cli
python main.py
Type of dose: breakfast
Carbs (g): 45
Need correction? (yes/no): no
cd v1.1_gui
python SimpleInsulinCalc_GUI_Refactored_Accessible.py
The calculator uses predefined insulin-to-carb ratios per meal type (e.g., breakfast: 1 unit per 5g), and applies correctional insulin units if required.
All math is performed as:
(total carbs / 10) * ratio [+ correction]
This tool is not a substitute for medical advice. Always consult your healthcare provider before making any changes to your insulin regimen.
Find an issue or have a suggestion? Submit it via the GitHub Issues page.