Failed to initialize the main window.

[Minfinity010]

Describe the bug
When trying to start the program on a new Arch installation, it outputs an error, saying "AttributeError: module 'transformers.file_utils' has no attribute 'default_cache_path'"

To Reproduce
Steps to reproduce the behavior:

1. Install for the first time/from scratch
2. Start the program to begin the setup
3. See error

Expected behavior
The program was expected to start its setup

Session Log

2026-03-15 14:29:28.876 | INFO     | pcleaner.cli_utils:dump_system_info:292 - 
- Program Information -
Program: Panel Cleaner 2.11.9
Executing from: /opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/gui/launcher.py
Log file: /home/<username>/.cache/pcleaner/pcleaner.log
Config file: /home/<username>/.config/pcleaner/pcleanerrc
Cache directory: /home/<username>/.cache/pcleaner
- System Information -
Operating System: Linux 6.19.7-1-cachyos
Desktop Environment: KDE
Python Version: 3.14.3 (main, Feb 18 2026, 14:39:20) [GCC 15.2.1 20260209]
PySide (Qt) Version: 6.10.2
Available Qt Themes: Breeze, Windows, Fusion
Current Qt Theme: System Default
Current Icon Theme: System Default
System locale: es_MX
Architecture: x86_64
CPU Cores: 4
Memory: 15.32 GiB
Swap: 15.31 GiB
GPU: None (CUDA not available)

2026-03-15 14:29:28.988 | INFO     | pcleaner.gui.launcher:launch:73 - Using locale es_MX.
2026-03-15 14:29:28.989 | DEBUG    | pcleaner.gui.launcher:launch:80 - Loaded built-in Qt translations for es_MX.
2026-03-15 14:29:28.989 | DEBUG    | pcleaner.gui.launcher:launch:88 - Loaded built-in Qt base translations for es_MX.
2026-03-15 14:29:29.056 | CRITICAL | pcleaner.gui.launcher:launch:123 - Failed to initialize the main window.
Traceback (most recent call last):

  File "/opt/pipx-panelcleaner/venvs/pcleaner/bin/pcleaner-gui", line 6, in <module>
    sys.exit(main())
    │   │    └ <function main at 0x7f969b1a97a0>
    │   └ <built-in function exit>
    └ <module 'sys' (built-in)>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/gui/launcher.py", line 139, in main
    launch(args.image_path, args.debug)
    │      │                └ {'--debug': False,
    │      │                   '<image_path>': []}
    │      └ {'--debug': False,
    │         '<image_path>': []}
    └ <function launch at 0x7f96bf3d24b0>
> File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/gui/launcher.py", line 119, in launch
    window = MainWindow(config, files_to_open, debug)
             │          │       │              └ False
             │          │       └ []
             │          └ Config(locale=None, current_profile=Profile(general=GeneralConfig(notes='', preferred_file_type=None, preferred_mask_file_typ...
             └ <class 'pcleaner.gui.mainwindow_driver.MainWindow'>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/gui/mainwindow_driver.py", line 134, in __init__
    self.ensure_models_downloaded()
    │    └ <function MainWindow.ensure_models_downloaded at 0x7f969b1828d0>
    └ <pcleaner.gui.mainwindow_driver.MainWindow(0x561c8c292940, name="MainWindow") at 0x7f969b027bc0>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/gui/mainwindow_driver.py", line 445, in ensure_models_downloaded
    has_ocr = md.is_ocr_downloaded()
              │  └ <function is_ocr_downloaded at 0x7f96ceea80f0>
              └ <module 'pcleaner.model_downloader' from '/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/model_d...
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/model_downloader.py", line 241, in is_ocr_downloaded
    return get_ocr_model_directory().is_dir()
           └ <function get_ocr_model_directory at 0x7f96c72cfed0>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/model_downloader.py", line 230, in get_ocr_model_directory
    cache_dir = Path(file_utils.default_cache_path)
                │    └ <module 'transformers.file_utils' from '/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/transformers/file_...
                └ <class 'pathlib.Path'>

AttributeError: module 'transformers.file_utils' has no attribute 'default_cache_path'

Screenshots
Before

After

Additional context
At first I was only going to report the bug, but I started to investigate and it turns out that it is because

The attribute default_cache_path was removed in recent versions of the transformers library (Hugging Face). PanelCleaner 2.11.9 is using an obsolete API of that library, there is a version incompatibility.
Source: Claude

and by changing
cache_dir = Path(file_utils.default_cache_path)
to
cache_dir = Path(os.getenv("HF_HOME", os.path.join(os.path.expanduser("~"), ".cache", "huggingface")))
at /opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner
the program starts normally

[Minfinity010]

It seemed to work well after that, now it got stuck with this:

2026-03-15 14:46:05.266 | INFO     | pcleaner.cli_utils:dump_system_info:292 - 
- Program Information -
Program: Panel Cleaner 2.11.9
Executing from: /opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/gui/launcher.py
Log file: /home/<username>/.cache/pcleaner/pcleaner.log
Config file: /home/<username>/.config/pcleaner/pcleanerrc
Cache directory: /home/<username>/.cache/pcleaner
- System Information -
Operating System: Linux 6.19.7-1-cachyos
Desktop Environment: KDE
Python Version: 3.14.3 (main, Feb 18 2026, 14:39:20) [GCC 15.2.1 20260209]
PySide (Qt) Version: 6.10.2
Available Qt Themes: Breeze, Windows, Fusion
Current Qt Theme: System Default
Current Icon Theme: System Default
System locale: es_MX
Architecture: x86_64
CPU Cores: 4
Memory: 15.32 GiB
Swap: 15.31 GiB
GPU: None (CUDA not available)

2026-03-15 14:46:05.379 | INFO     | pcleaner.gui.launcher:launch:73 - Using locale es_MX.
2026-03-15 14:46:05.380 | DEBUG    | pcleaner.gui.launcher:launch:80 - Loaded built-in Qt translations for es_MX.
2026-03-15 14:46:05.381 | DEBUG    | pcleaner.gui.launcher:launch:88 - Loaded built-in Qt base translations for es_MX.
2026-03-15 14:46:07.237 | INFO     | manga_ocr.ocr:__init__:16 - Loading OCR model from kha-white/manga-ocr-base
2026-03-15 14:46:08.247 | ERROR    | pcleaner.gui.model_downloader_driver:parse_ocr_progress:515 - Could not parse ocr download progress data: "config.json: 0.00B [00:00, ?B/s]"
2026-03-15 14:46:08.251 | ERROR    | pcleaner.gui.model_downloader_driver:parse_ocr_progress:515 - Could not parse ocr download progress data: "config.json: 77.5kB [00:00, 16.0MB/s]"
2026-03-15 14:46:09.220 | ERROR    | pcleaner.gui.model_downloader_driver:parse_ocr_progress:515 - Could not parse ocr download progress data: "vocab.txt: 0.00B [00:00, ?B/s]"
2026-03-15 14:46:09.226 | ERROR    | pcleaner.gui.model_downloader_driver:parse_ocr_progress:515 - Could not parse ocr download progress data: "vocab.txt: 24.1kB [00:00, 15.8MB/s]"
2026-03-15 14:46:50.411 | ERROR    | pcleaner.gui.model_downloader_driver:parse_ocr_progress:515 - Could not parse ocr download progress data: "�[A"
2026-03-15 14:46:50.614 | CRITICAL | pcleaner.gui.model_downloader_driver:ocr_error:257 - 'CaptureOutput' object has no attribute 'isatty'
Traceback (most recent call last):

> File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/gui/worker_thread.py", line 141, in run
    result = self.fn(*self.args, **self.kwargs)
             │    │   │    │       │    └ {}
             │    │   │    │       └ <pcleaner.gui.worker_thread.Worker object at 0x7fea2c9b0680>
             │    │   │    └ (<pcleaner.gui.gui_utils.CaptureOutput(0x55ace1f74a40) at 0x7fea2c9b04c0>,)
             │    │   └ <pcleaner.gui.worker_thread.Worker object at 0x7fea2c9b0680>
             │    └ <function ocr_download_worker at 0x7fea2cb487d0>
             └ <pcleaner.gui.worker_thread.Worker object at 0x7fea2c9b0680>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/pcleaner/gui/model_downloader_driver.py", line 356, in ocr_download_worker
    MangaOcr()
    └ <class 'manga_ocr.ocr.MangaOcr'>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/manga_ocr/ocr.py", line 19, in __init__
    self.model = MangaOcrModel.from_pretrained(pretrained_model_name_or_path)
    │            │             │               └ 'kha-white/manga-ocr-base'
    │            │             └ <classmethod(<function PreTrainedModel.from_pretrained at 0x7fea59162610>)>
    │            └ <class 'manga_ocr.ocr.MangaOcrModel'>
    └ <manga_ocr.ocr.MangaOcr object at 0x7fea2ca72cf0>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/transformers/modeling_utils.py", line 4138, in from_pretrained
    loading_info = cls._finalize_model_loading(model, load_config, loading_info)
                   │   │                       │      │            └ LoadStateDictInfo(missing_keys=set(), unexpected_keys={'decoder.bert.embeddings.position_ids'}, mismatched_keys=set(), error_...
                   │   │                       │      └ LoadStateDictConfig(pretrained_model_name_or_path='kha-white/manga-ocr-base', download_kwargs={'cache_dir': None, 'force_down...
                   │   │                       └ MangaOcrModel(
                   │   │                           (encoder): ViTModel(
                   │   │                             (embeddings): ViTEmbeddings(
                   │   │                               (patch_embeddings): ViTPatchEmbeddings(
                   │   │                                 ...
                   │   └ <staticmethod(<function PreTrainedModel._finalize_model_loading at 0x7fea591628d0>)>
                   └ <class 'manga_ocr.ocr.MangaOcrModel'>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/transformers/modeling_utils.py", line 4299, in _finalize_model_loading
    log_state_dict_report(
    └ <function log_state_dict_report at 0x7fea5cdcef00>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/transformers/utils/loading_report.py", line 262, in log_state_dict_report
    report = loading_info.create_loading_report()
             │            └ <function LoadStateDictInfo.create_loading_report at 0x7fea5cdcecf0>
             └ LoadStateDictInfo(missing_keys=set(), unexpected_keys={'decoder.bert.embeddings.position_ids'}, mismatched_keys=set(), error_...
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/transformers/utils/loading_report.py", line 182, in create_loading_report
    f"\n- {_color('UNEXPECTED', 'orange') + PALETTE['italic']}\t:can be ignored when loading from different "
           │                                └ {'reset': '\x1b[0m', 'red': '\x1b[31m', 'yellow': '\x1b[33m', 'orange': '\x1b[38;5;208m', 'purple': '\x1b[35m', 'bold': '\x1b...
           └ <function _color at 0x7fea5cdce8d0>
  File "/opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/transformers/utils/loading_report.py", line 123, in _color
    if sys.stdout.isatty():
       │   │      └ <method 'isatty' of '_io.TextIOWrapper' objects>
       │   └ <_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>
       └ <module 'sys' (built-in)>

AttributeError: 'CaptureOutput' object has no attribute 'isatty'

and now that was solved by changing
if sys.stdout.isatty():
to
if hasattr(sys.stdout, 'isatty') and sys.stdout.isatty():
at /opt/pipx-panelcleaner/venvs/pcleaner/lib/python3.14/site-packages/transformers/utils/loading_report.py

[VoxelCubes]

Deprecation issues, lovely.
Thank you very much for pointing this out!
I'll try to fix this today or on the weekend.

As a workaround, you can try downgrading huggingface, it appears to be the culprit.