Dependency Conflicts Between unsloth, unsloth_zoo, torch, triton, and transformers in Python 3.10 Environment

[MinaArzaghi]

Hi,
I'm setting up unsloth and unsloth_zoo in a clean environment using Python 3.10 and uv, and ran into several dependency conflicts:

unsloth-zoo==2025.3.11 requires triton >= 3.0.0, but torch==2.2.2 strictly requires triton==2.2.0. This creates a direct conflict between unsloth-zoo and torch.

unsloth-zoo==2025.3.17 introduces version constraints on transformers:

Only allows transformers >= 4.46.1, < 4.47.0 or > 4.47.0

This explicitly excludes transformers==4.47.0, which is the version where CompileConfig was introduced — required by recent unsloth code. This leads to an incompatibility in environments where transformers==4.47.0 is needed.

The latest commit on the main branch of unsloth_zoo raises a SyntaxError:

SyntaxError: non-default argument follows default argument in UnslothGKDTrainer.py (line 625)

This breaks initialization of FastLanguageModel.

Attempts to roll back to earlier commits of unsloth_zoo failed because specific commits were either missing, untagged, or incompatible with unsloth==2025.3.13.

It’s currently unclear which combination of unsloth, unsloth_zoo, torch, triton, transformers, and peft are officially supported and stable. uv's strict resolver makes these conflicts visible and reproducible.

Would be helpful to have an officially supported compatibility matrix or lockfile to avoid these issues.