Registry / llm-agents / unsloth-zoo

unsloth-zoo

JSON →
library2026.8.16pypypi✓ verified 24d ago

Unsloth Zoo provides a collection of plug-and-play utilities and example modules designed to work with the Unsloth library for efficient LLM fine-tuning. It includes components for dataset loading, SFT (Supervised Fine-Tuning) trainers, tokenizer utilities, and metrics. As of version 2026.4.6, it aims to simplify and standardize common LLM fine-tuning workflows built on Unsloth, with frequent updates aligning with Unsloth's development.

pip install unsloth-zoo
INSTALL
IMPORT
SIG · UNSLOTH-ZOO
U
unsloth-zoo
llm-agentspythonv2026.8.16
Install
93.0s avg
Import
Disk
5299MB
Pass rate
4/ 10
Env Coverage4 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v2026.8.16 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✕ build_error
✓ 105.7s
py 3.11
✕ build_error
✓ 95.2s
py 3.12
✕ build_error
✓ 90.2s
py 3.13
✕ build_error
✓ 80.7s
py 3.9
✕ build_error
✕ timeout
5299MB installed
● package 5299MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

Trainer
from unsloth_zoo import Trainer
from unsloth_zoo import Trainer

This quickstart demonstrates how to load a dataset using Unsloth Zoo's data loading utilities. It configures a dataset using a `DatasetConfig` and then loads it with `load_dataset`, showcasing a common first step in preparing data for fine-tuning.

from unsloth_zoo.data.configs import DatasetConfig from unsloth_zoo.data.loader import load_dataset # Configure a dataset, e.g., using a predefined template config = DatasetConfig(dataset_name="alpaca_template") # Load the dataset dataset = load_dataset(config) print(f"Loaded dataset with {len(dataset)} examples.") if len(dataset) > 0: print("First example:") print(dataset[0])
Debug
Known issues
breakingUnsloth Zoo's API and underlying logic are tightly coupled with the `unsloth` library. Major and even minor version updates of `unsloth` can introduce breaking changes that require `unsloth-zoo` to be updated simultaneously. Mismatched versions can lead to runtime errors or incorrect behavior.
fix
Always install `unsloth-zoo` and `unsloth` together, preferably ensuring they are compatible. Refer to the `unsloth-zoo` README or `unsloth` documentation for recommended version pairings. Frequently update both libraries to their latest compatible versions.
affects: All versions
gotchaDataset templates provided by `unsloth_zoo.data` expect specific JSON or text formats. When using custom datasets, ensure they strictly adhere to these templates (e.g., 'instruction', 'input', 'output' fields for chat templates) to avoid parsing errors or incorrect model training.
fix
Review the source code or documentation for the specific `DatasetConfig` template you are using to understand the expected format. Validate your custom dataset's structure before loading it with `unsloth_zoo.data.loader`.
affects: All versions
gotchaPerformance and resource usage of `unsloth-zoo` modules are heavily dependent on the `unsloth` backend and correct GPU setup. Misconfigurations (e.g., incorrect CUDA version, missing `bitsandbytes` installation, incompatible PyTorch) will result in poor performance or errors.
fix
Ensure your system meets `unsloth`'s GPU requirements. Verify `bitsandbytes` is installed for quantization. Follow `unsloth`'s official installation instructions for your specific CUDA/PyTorch setup before attempting to use `unsloth-zoo`.
affects: All versions
Upgrade
Version history
2026.8.16latest on PyPI · released Aug 27, 2026
Audit
Dependencies
unslothrequiredCore functionality relies heavily on the Unsloth library for LLM fine-tuning.
torchrequiredUnsloth (and thus unsloth-zoo) requires PyTorch for GPU acceleration.
transformersrequiredLeverages Hugging Face Transformers for models and tokenizers.
Agent activity
57 hits · last 30 days
node
52
Perplexity
1
OpenAI (training)
1
Resources
unsloth-zoo — pip install unsloth-zoo · libregistry