Skip to content

v1.5.9

Release date: 2026-05-29

v1.5.9 is the research-output and update-experience patch. It fixes the practical problem where users had to remember long pip install commands before they could reach the newest SDK features.

Highlights

1. iints update

The SDK now has a top-level updater:

iints update
iints update --dry-run
iints update --source github --yes

The command updates the same Python environment that launched iints, prints the exact pip command before running it, and supports PyPI or GitHub source installs.

2. Automatic run-quality artifacts

Normal runs now write reviewer-facing quality outputs into the run folder:

realism_report.json
realism_dashboard.html
safety_visualizer.html
safety_visualizer.json

This makes every simulation bundle easier to inspect during research, demos, and review.

3. Safety contract visualizer

The new command:

iints safety-visualize --results-csv results/run/results.csv

creates a standalone HTML page showing glucose trace, safety interventions, top safety reasons, insulin reduced by safety logic, and time-in-range summaries.

4. AGP PNG export

AGP-style reporting can now export presentation-ready PNG assets:

iints report --results-csv results/run/results.csv --style agp --png --bundle-dir results/run/agp

This writes agp_profile.png, daily_profiles.png, agp_summary.json, and agp_report.pdf.

5. Documentation polish

The docs now include a clearer project-boundary page, updated command cheatsheets, updater guidance, and AGP/safety-visualizer examples.

Upgrade

If you are still on v1.5.8, iints update does not exist yet. Do this once:

python -m pip install -U "iints-sdk-python35[full,mdmp,research,edge]==1.5.9"
hash -r
iints --version

After that, future upgrades can use:

iints update

Validation

Focused checks before release:

python3 -m pytest tests/test_cli_onboarding.py tests/test_cli_research_workflows.py tests/regression/test_pdf_regression.py tests/test_cli_run_summary.py -q
python3 -m mypy src/iints/analysis/safety_visualizer.py src/iints/analysis/run_quality.py src/iints/analysis/reporting.py src/iints/cli/cli.py src/iints/highlevel.py src/iints/__init__.py
python3 -m flake8 src/iints/analysis/safety_visualizer.py src/iints/analysis/run_quality.py src/iints/analysis/reporting.py src/iints/cli/cli.py src/iints/highlevel.py src/iints/__init__.py tests/test_cli_onboarding.py tests/test_cli_research_workflows.py tests/regression/test_pdf_regression.py
python3 tools/ci/check_docs_examples.py
mkdocs build --strict

Results:

  • 28 passed
  • mypy: success
  • flake8: success
  • 61 documented CLI command paths validated
  • docs build succeeded

Practical takeaway

This is the release that makes IINTS easier to maintain on real machines: install it once manually, then use iints update going forward.