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 :doc:`../tutorial/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 :doc:`../gui/index` for the planned scope and developer preview.

Data
----

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

**Folder layout**: :doc:`../how_to/prepare_data` .

Support: |link_github_issues| · lichao19870617@163.com