Troubleshooting

This page is for: when a command failed and you want the shortest path to a fix.

Before this page: Installation if the SDK may not be installed correctly.

After this page: Command Reference if you need to confirm the right command shape.

First Recovery Commands

iints doctor --full --suggest
iints demo --dry-run
iints run --dry-run --preset baseline_t1d

Common Problems

Algorithm file not found

What it usually means: - the path is wrong - you are not in the project folder you expected

Good fixes:

pwd
ls algorithms
iints demo

If the CLI shows Did you mean ..., use that path directly.

Scenario file not found

Good fixes:

ls scenarios
iints scenarios generate --output-path scenarios/generated_scenario.json

Or skip the scenario file and use a preset:

iints run --preset baseline_t1d

Patient config file not found

Good fixes:

iints profiles create --name my_profile
ls patient_profiles

Or use a built-in preset:

iints run --preset baseline_t1d

No such command ...

This usually means the installed CLI is older than the docs or repo checkout.

Good fixes:

python -m pip install -U pip
python -m pip install -U -e ".[full,mdmp]"
hash -r
iints --help

demo-booth, AI, or reporting commands are missing

Install the reporting stack:

python -m pip install -U "iints-sdk-python35[reports]"

Or everything:

python -m pip install -U "iints-sdk-python35[full]"

Public dataset fetch says verification failed

That is often expected for public packs without a pinned hash yet.

Use:

iints data fetch aide_t1d --no-verify --output-dir data_packs/public/aide_t1d

Only do this when you trust the source and understand that verification is relaxed.

Raspberry Pi / Maker Faire setup is confusing

Use these in order: - Maker Faire Pi Mode - Maker Faire Pi Checklist - Raspberry Pi Digital Patient

Before Filing A Bug

Collect these:

iints doctor --full --suggest
iints --help
python -V

And include: - the exact command you ran - the full error text - your OS and Python version

Where To Go Next

If the issue is fixed and you want to...	Continue with
run the first demo	Quickstart
continue the full workflow	Getting Started
check command syntax	Command Reference
troubleshoot edge hardware	Raspberry Pi Digital Patient
understand docs routes again	User Guide Map