gitwtfhub

wtf is transformers5-qwen3.5-recipe?

woct0rdho/transformers5-qwen3.5-recipe — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · researcherComplexity · 5/5Setup · hard

TL;DR

A technical recipe for fine-tuning large Qwen3.5/3.6 language models on limited GPU memory using GGUF-format base models and LoRA training.

Mindmap

mindmap
  root((transformers5-qwen3.5-recipe))
    What it does
      LoRA fine-tuning recipe
      GGUF base model loading
      Low VRAM training
      Tuned for Strix Halo GPU
    Tech stack
      Python
      PyTorch
      Transformers
      PEFT and TRL
      Triton kernels
    Use cases
      Fine-tune MoE language models
      Train on limited VRAM
      Port kernels to other GPUs
    Audience
      ML researchers
      GPU kernel developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Fine-tune large Qwen3.5 or Qwen3.6 mixture-of-experts models on a single consumer GPU with limited VRAM.

REASON 2

Train LoRA adapters against GGUF-quantized base models instead of full safetensors checkpoints.

REASON 3

Adapt tuned Triton kernels for mixture-of-experts and attention layers to other GPU architectures.

What's in the stack?

PythonPyTorchTransformersPEFTTRLTritonGGUF

How it stacks up

woct0rdho/transformers5-qwen3.5-recipe0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultyhardeasyhard
Complexity5/52/55/5
Audienceresearchergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires a GPU with substantial VRAM plus manual patching of Transformers and related libraries.

No license information is stated in the README.

Wtf does this do

This repository is a training recipe for fine-tuning large Qwen3.5 and Qwen3.6 language models on consumer-grade graphics cards with limited video memory. It uses a technique called LoRA, which lets you adjust a large model's behavior by training a small set of extra parameters instead of retraining the whole model, saving both time and memory. The key idea is to load the base model in the GGUF format, a compact file format normally used for running models rather than training them. According to the author, GGUF is on track to replace an older format called bitsandbytes for this kind of low-memory training. Using this approach, the author reports training a 35 billion parameter model on 16 gigabytes of video memory with no need to offload work to the computer's regular memory, and even larger models on higher-memory setups. The recipe was built and tuned specifically for a particular AMD GPU architecture called Strix Halo, though the author notes it should be possible to adapt it to other graphics cards with some effort. It combines a long list of technical building blocks: a custom GGUF loader for the Transformers library, compiled dequantization steps to save memory, tuned matrix multiplication kernels, custom Triton kernels for the model's mixture of experts layers and attention mechanism, alternative normalization and loss calculation methods, and a memory-efficient optimizer. This is a highly specialized, code-first project aimed at machine learning practitioners and researchers who are already comfortable with model training internals, GPU kernels, and the Hugging Face Transformers ecosystem. It is not a beginner tool and assumes deep familiarity with the underlying training stack. The README documents the technical choices made rather than offering step-by-step setup instructions, so using this repo requires reading the linked source code and related GitHub discussions to understand how the pieces fit together.

Yoink these prompts

Prompt 1
Explain how this repo uses GGUF quantization to train Qwen3.5 models with less VRAM than usual.
Prompt 2
Walk me through adapting the tuned kernels in this repo from Strix Halo to a different GPU.
Prompt 3
What does LoRA training against a GGUF base model involve compared to training against safetensors?
Prompt 4
Summarize the training loop and optimizer choices this recipe uses for low-VRAM MoE fine-tuning.

Frequently asked questions

wtf is transformers5-qwen3.5-recipe?

A technical recipe for fine-tuning large Qwen3.5/3.6 language models on limited GPU memory using GGUF-format base models and LoRA training.

What language is transformers5-qwen3.5-recipe written in?

Mainly Python. The stack also includes Python, PyTorch, Transformers.

What license does transformers5-qwen3.5-recipe use?

No license information is stated in the README.

How hard is transformers5-qwen3.5-recipe to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is transformers5-qwen3.5-recipe for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.