v0.4.1

Fixed

pip install ragmill[all] now works on a clean machine.

The all (and dev) extras pulled llama-cpp-python, which ships no PyPI wheels for recent versions. pip fell back to a 70 MB+ sdist that vendors llama.cpp — that needs a C++ toolchain, and on Windows the vendored tree exceeds the 260-character MAX_PATH limit, aborting the entire install before anything was written:

ERROR: Could not install packages due to an OSError: [Errno 2] No such file or
directory: 'C:\...\vendor\llama.cpp\tools\ui\...'

[all] and [dev] now resolve to wheels on every platform. The local LLM is opt-in — install a prebuilt wheel, which needs no compiler:

pip install llama-cpp-python --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cpu

Or skip the local model entirely with a hosted backend (ragmill[chat-gemini], ragmill[chat-openai]) — both are included in [all].

Missing-dependency errors now name a command for your own OS.

tesseract and poppler's pdftoppm cannot come from pip, so these messages are the only guidance available — and they previously suggested brew install on every platform, useless on Windows and Linux. They now select per platform (UB-Mannheim installer / poppler-windows on Windows, brew on macOS, apt-get on Linux). The scanned-PDF error also mentions enable_ocr=False, so opting out of OCR is as discoverable as opting in.

The "local chat backend unavailable" error no longer points solely at pip install "ragmill[chat]" — the command that fails on Windows. It now leads with the prebuilt-wheel index, explains why the package is not bundled, and offers the hosted backends.

Source distributions are built from an allowlist.

The sdist previously included every file that .gitignore did not exclude, so a maintainer's local scratch directories could be swept into a locally built tarball. It now ships an explicit list of paths.

Upgrading

pip install --upgrade "ragmill[all]"

No API or configuration changes — 0.4.1 is a packaging and diagnostics fix only.