Skip to content
This repository was archived by the owner on Aug 6, 2026. It is now read-only.

CHANGELOG.md

Latest commit

 

History

History
44 lines (39 loc) · 2.34 KB

CHANGELOG.md

File metadata and controls

44 lines (39 loc) · 2.34 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0] - 2026-06-18

Added

  • Initial release.
  • fix-unsloth-libhsa.sh shell script that parks the bundled libhsa-runtime64.so.1.21.0 to hsa-bundled.bak/ and replaces it with a symlink to the system /opt/rocm/lib/libhsa-runtime64.so.1 (1.18.x).
  • Re-adds ROCR_VISIBLE_DEVICES=0 to ~/.local/share/unsloth/studio.conf if the Unsloth installer stripped it on an update.
  • Prunes stale unsloth_studio.rollback.* directories (each is a full ~15 GB venv left over from failed or cancelled updates).
  • fix-unsloth-libhsa.path systemd user unit: PathChanged on ~/.unsloth/llama.cpp/build/bin/ plus PathModified on ~/.local/share/unsloth/studio.conf. Triggers the service whenever any file in the bundled directory is replaced, including the unlink-then- recreate pattern used by tar-based installers that defeated the previous PathModified-on-file watcher.
  • fix-unsloth-libhsa.service systemd user unit: runs the fix script as a oneshot. Idempotent and safe to run repeatedly.
  • fix-unsloth-libhsa-backup.timer systemd user unit: a daily backup that re-runs the fix even if the path unit's inotify watcher misses an event.
  • install.sh and uninstall.sh for one-shot setup and teardown.
  • Documentation in four literary styles: DOCUMENTATION.md.
  • Focused technical notes in docs/: PROBLEM.md, SOLUTION.md, VERIFICATION.md, COMPATIBILITY.md, FUTURE.md.

Known limitations

  • Only covers libhsa-runtime64.so.1. The same pattern could in principle affect any other bundled ROCm library if AMD/Unsloth release an incompatible combination. The hardened directory-level path watcher makes it cheap to extend the fix to additional files (see docs/FUTURE.md).
  • Does not intercept unsloth studio update at the CLI level. The fix reacts after the prebuilt has been re-extracted, which is fast (sub- second) but reactive rather than preventive.
  • Does not pin the system ROCm package. A system update of hsa-rocr that removes libhsa-runtime64.so.1 would break the symlink. Mitigation: the daily timer would log the failure and notify-send if available.