FAQ

Installation

``habit`` not found

  • Windows lightweight installer: double-click launchers/启动HABIT命令行.bat (after launchers/一键安装HABIT.bat succeeds).

  • Source: conda activate habit .

Installer path rejected

Use a short local path with ASCII characters only and no spaces (for example D:\HABIT).

CUDA False

Normal for the default CPU environment. After launchers/一键启用HABIT-GPU.bat, check NVIDIA drivers; see Installation .

``Parquet export requires pyarrow``

Current default installs include pyarrow. Rebuild or re-run launchers/一键安装HABIT.bat so the environment picks up the updated runtime lock. Temporary workaround: pip install pyarrow==20.0.0 inside the HABIT command-line session.

Runtime

Path / file errors

  • Run from project root (contains config/ ).

  • Check data_dir / out_dir in YAML.

  • Relative paths are resolved from the YAML file directory.

Command failed

  1. habit <subcommand> --help

  2. Check processing.log in the output folder.

  3. habit get-habitat ... --debug for habitat jobs.

YAML changes ignored

Confirm you edit the file passed with -c ; --mode on CLI overrides run_mode in YAML.

GUI (under development)

The Web GUI is not yet recommended for routine use. Prefer the CLI and YAML configs; see Web GUI (under development) for the planned scope and developer preview.

Data

ROI format: NIfTI aligned with images (ITK-SNAP / 3D Slicer).

Folder layout: Prepare data .

Support: GitHub Issues · lichao19870617@163.com