imcui.ui.config_utils

Configuration utilities and path management

imcui.ui.config_utils

Configuration utilities and path management functions.

Functions

get_default_config_path

Get the default configuration file path.

from imcui import get_default_config_path

config_path = get_default_config_path()
print(f"Config path: {config_path}")

Returns:

Path string to the configuration file. Searches in priority order:

1. cwd/app.yaml
2. cwd/config/app.yaml
3. Package default configuration

get_example_data_path

Get the example datasets path with auto-download support.

from imcui import get_example_data_path

data_path = get_example_data_path()
print(f"Datasets path: {data_path}")

Returns:

Path string to the example datasets directory. Automatically downloads from HuggingFace on first run if not found.

Environment Variables:

• IMCUI_DATA_DIR: Override default datasets path

get_version

Get the current package version.

from imcui import get_version

version = get_version()
print(f"IMCUI version: {version}")

Returns:

Version string (e.g., “1.0.0”).

Path Resolution

Configuration Path Priority

1. Custom path via -c flag
2. cwd/app.yaml
3. cwd/config/app.yaml
4. Package default

Dataset Path Priority

1. Environment variable IMCUI_DATA_DIR
2. User cache directory (auto-download):
   • Linux/macOS: ~/.cache/imcui/datasets/
   • Windows: %LOCALAPPDATA%\imcui\datasets\
3. CLI flag -d /path/to/datasets

Source Code: imcui/ui/config_utils.py