Maintenance release. If you hit an install or load problem on v0.2.0, update to this release — it fixes several first-run issues.
Fixes
- Model load no longer hangs silently. The engine now prints load progress (
# loading,# mapped experts (N GB)) and the client waits for readiness with a bounded, correct timeout — a stalled or misconfigured load fails with a clear message instead of hanging forever. midge searchno longer crashes. It previously raised a TypeError against newerhuggingface_hub; it now adapts to the installed version and degrades gracefully offline.- Friendly errors on a fresh machine.
midge --helpand every command now print a clear "missing package — run pip install -r requirements.txt" message on a dependency-free Python instead of a traceback. - Optional-dependency test suites skip cleanly (
make test-mlx,make test-server) whenmlx/openaiaren't installed, instead of erroring. - Added
SUPPORT.mdand an issue template with load-hang triage and the exact startup lines to expect.
Verified
AddressSanitizer + UBSan clean; clang + strict gcc builds pass; fresh-clone install.sh in a bare venv; C, MLX, and UI suites green in CI; the convert→load→chat flow shows progress with no hang. Regression tests added for the search crash and the bare-Python guard.
See SUPPORT.md if you hit trouble.