●Change8

Migrating to Unsloth v0.1.0-beta

Version v0.1.0-beta introduces 2 breaking changes. This guide details how to update your code.

Released: 3/17/2026

2
Breaking Changes
9
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

TRL trainer configsllm_int8_skip_modules_get_per_token_logps_and_entropiesdata-designer pluginsetup.sh

Breaking Changes

●Issue #1

Removed Blackwell flex attention disable workaround from studio. This might affect users running on specific Blackwell hardware configurations if they relied on the previous workaround.

●Issue #2

Applied removal of `use_reentrant` to all TRL trainer configs. Users relying on this specific parameter in custom TRL setups might need to adjust their configurations.

Migration Steps

  1. 1
    For MacOS/Linux/WSL users: Ensure `cmake` is installed. If not, run `brew install cmake`.
  2. 2
    For MacOS/Linux/WSL users: Install `uv` using `curl -LsSf https://astral.sh/uv/install.sh | sh`.
  3. 3
    For Windows users: Install Python 3.13 using `winget install -e --id Python.Python.3.13`.
  4. 4
    For Windows users: Install `uv` using `winget install --id=astral-sh.uv -e`.
  5. 5
    All users should use `uv venv unsloth_studio --python 3.13` to create environments.
  6. 6
    All users should install Unsloth via `uv pip install unsloth --torch-backend=auto`.
  7. 7
    Run `unsloth studio setup` to initialize the Studio environment.
  8. 8
    Launch Studio using `unsloth studio -H 0.0.0.0 -p 8888`.
  9. 9
    For Docker users, use the provided `docker run` command, ensuring to set a password for Jupyter.

Release Summary

This release introduces Unsloth Studio (Beta), a new web UI for training and running LLMs, alongside significant feature additions like Mixtral support, ROCM compatibility, and various stability and security fixes across the platform.

Need More Details?

View the full release notes and all changes for Unsloth v0.1.0-beta.

View Full Changelog