i4h-catheter-navigation-setup

Verifies host, GPU, and PYTHONPATH requirements for the Isaac for Healthcare catheter navigation workflow.

3.2k|370|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/NVIDIA/skills --skill i4h-catheter-navigation-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: i4h-catheter-navigation-setup
Source: https://github.com/NVIDIA/skills/tree/main/skills/i4h-catheter-navigation-setup
Command: npx skills add https://github.com/NVIDIA/skills --skill i4h-catheter-navigation-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up the Isaac for Healthcare (i4h) catheter navigation workflow fails when host requirements, GPU drivers, or PYTHONPATH are misconfigured, producing confusing import, slangpy, and CUDA errors. This Skill walks an agent through preflight checks, CLI registration verification, and CPU smoke tests so setup problems are diagnosed systematically instead of by trial and error.

Core Features & Use Cases

  • Host and GPU preflight: Checks python3, git, nvidia-smi, and disk space against documented requirements (Linux x86_64, NVIDIA GPU CC >= 7.0, CUDA 12.8-compatible driver, 16 GB RAM, 20 GB disk).
  • CLI registration and smoke tests: Verifies ./i4h modes catheter_navigation registration and runs the 7-test fluorosim CPU smoke suite, logging results to a timestamped run directory.
  • Optional GPU sanity check: Renders a synthetic DRR image when slangpy, Warp, and CUDA are available, and falls back to Docker guidance when host GPU dependencies are incomplete.
  • Use Case: A developer hits fluorosim import errors when launching the catheter viewport; the agent exports the simulation PYTHONPATH, reruns the smoke tests, and recommends the Docker path for missing GPU dependencies.

Quick Start

Ask your agent to set up the catheter navigation workflow and report which host requirements or dependencies are missing.

Frequently Asked Questions about i4h-catheter-navigation-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the i4h catheter navigation workflow?

Resolve the i4h-workflows repository root, export workflows/catheter_navigation/scripts/simulation onto PYTHONPATH, then verify registration with ./i4h modes catheter_navigation and run the CPU smoke tests. The skill clones the repo to ~/i4h-workflows if no checkout exists.

Why does the fluorosim import fail in catheter navigation?

The fluorosim import fails because PYTHONPATH does not include the workflow's scripts/simulation directory. Re-export PYTHONPATH with SIM_ROOT set to workflows/catheter_navigation/scripts/simulation, then confirm with python3 -c "import fluorosim".

Can I verify catheter navigation without a GPU?

Yes, the CPU smoke suite of 7 unittest tests runs without a GPU and is sufficient for CI-style verification. The synthetic DRR render check is optional and should be skipped on headless or GPU-less runners.

What are the host requirements for catheter navigation GPU modes?

GPU modes require Linux x86_64 (Ubuntu 22.04/24.04 tested), an NVIDIA GPU with compute capability 7.0 or higher, a CUDA 12.8-compatible driver, at least 16 GB RAM, 20 GB disk, plus slangpy, Warp, and CUDA-enabled torch.

What should I do when slangpy or CUDA dependencies are missing?

Use the workflow's Docker image by running ./i4h run catheter_navigation render_drr without the --local flag, which avoids installing GPU dependencies on the host. Alternatively install slangpy, Warp, and CUDA per the workflow README.