wigolo compatible with macOS 10.15 Catalina, or does it require macOS 11+?

[glaypan]

I noticed wigolo fails to install due to a missing dependency @huggingface/tasks@^0.21.28. Here's my setup:

My environment:

• MacBook Pro (2012), macOS 10.15 Catalina
• Node.js v23.11.1
• 16GB RAM
• Running Hermes Agent

Installation attempt:

$ npx -y wigolo --version
npm error code ETARGET
npm error notarget No matching version found for @huggingface/tasks@^0.21.28

$ npm install -g wigolo
Same error — @huggingface/tasks@^0.21.28 doesn't exist on npm.

Questions:

1. Is @huggingface/tasks@^0.21.28 a typo or an unpublished version? The latest available on npm seems different.
2. Are there any plans to fix this dependency so wigolo can be installed on systems without this specific version?
3. Is wigolo compatible with macOS 10.15 Catalina, or does it require macOS 11+?

Thanks!

---

直接复制去提 issue 就行，喵～😽💕

[KnockOutEZ]

Hey @glaypan 👋 Thanks for the detailed report — I'll look into it and ship a fix soon so the install doesn't depend on that version window.

Quick context on the error: @huggingface/tasks isn't a direct wigolo dependency — it gets pulled in transitively by the ML reranker (@huggingface/transformers). The ^0.21.28 range is real (not a typo), but you caught it during a gap where the transformers chain requested a version that hadn't finished propagating to npm yet, so your resolver couldn't match it.

For the time being, could you try clearing your npm cache and reinstalling? That version is on the registry now, so a fresh resolve should pick it up:

npm cache clean --force
npx -y wigolo@latest --version

Answering your questions directly:

1. Not a typo — transitive dep of the reranker library. It exists now; the earlier failure was a registry-propagation/cache timing issue.
2. Yes — I'll pin the dependency in the next release so install never depends on that range resolving live.
3. Honest heads-up: wigolo relies on native modules (an embedded SQLite engine + ONNX runtime), whose prebuilt binaries target macOS 11+. On 10.15 Catalina you may get past this error but hit a native-binary wall — I can't promise Catalina support, though I'm happy to help you try a build-from-source path if you want to push further.

Thanks again for flagging it 🙏