Troubleshooting
Work from the failing stage: configuration, declaration, initialization, placement, or request handling.
Missing credentials / 401
The client did not receive a usable credential. Run infimal whoami, check INFIMAL_API_KEY and INFIMAL_API_URL, and confirm the key belongs to that environment. Do not print the key to diagnose it.
infimal billing balance --jsonModule or model import fails
Run from the project directory that contains your module, or use an importable package path. Verify that dependencies are installed in the same Python environment as infimal. Move expensive model loading into setup so planning does not initialize the model.
SnapshotBoundaryError
Inspect the object returned by setup for open connections, file handles, or background resources that cannot survive checkpointing. Close temporary setup resources and establish external connections inside the handler when needed.
Then rebuild and inspect build logs. A successful object check only covers common failure cases.
infimal apps logs asr-emotion-checkpoint4200 --limit 100BatchShapeError
The handler returned a different number of results than requests. Check grouping, output ordering, and single-item behavior. Do not collapse a batch to one aggregate result unless your endpoint contract explicitly uses that shape outside the batched handler.
Requests wait after deployment
Inspect status to see whether placement or restore is still in progress. Verify that replica limits fit the workload and that the environment can place the model. Do not assume a higher declared maximum reserves hardware.
infimal apps status asr-emotion-checkpoint4200
infimal apps snapshots asr-emotion-checkpoint4200