IINTS-AF SDK Documentation¶

IINTS-AF is a safety-first research SDK for insulin algorithm simulation, validation, and audit-ready reporting.

Use a Virtual Environment

Always run SDK commands from an active Python virtual environment (.venv). This avoids package conflicts and missing dependency issues.

Start Here¶

Choose Your Path¶

New to IINTS	Build First Run	Validate Data (MDMP)	Engineering Reference
Plain Language Overview	Quick Start	MDMP Quickstart	Developer CLI Guide
Understand what the SDK does and does not do.	Install, run baseline, inspect outputs.	Validate contracts, compute grades, export dashboard.	Full command reference and technical integration details.

10-Minute Quick Start¶

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
pip install iints-sdk-python35

iints doctor --smoke-run
iints quickstart --project-name iints_quickstart
cd iints_quickstart
iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py

Expected outputs: - results.csv - clinical_report.pdf - audit/ - run_manifest.json

MDMP in 60 Seconds¶

MDMP is the IINTS data-quality protocol.

Contract: required columns, types, units, and value bounds.
Validation: dataset is checked against contract rules.
Grading: output receives draft, research_grade, or clinical_grade.
Fingerprinting: deterministic hashes support reproducibility and audits.

Use MDMP with:

iints mdmp template --output-path mdmp_contract.yaml
iints mdmp validate mdmp_contract.yaml data/my_cgm.csv --output-json results/mdmp_report.json
iints mdmp visualizer results/mdmp_report.json --output-html results/mdmp_dashboard.html

Scope¶

Research use only.
Not a medical device.
No clinical dosing advice.