import gradio as gr from datasets import load_dataset from trl import SFTTrainer, SFTConfig from transformers import AutoTokenizer import pandas as pd import numpy as np TRUNCATION_LENGTHS = [128, 256, 512, 1024, 2048, 4096, 8192, 16384, 32768] SEED = 42 N_SAMPLES = 1000 CODE_TEMPLATE = """ training_args = SFTConfig( ..., max_length={}, )""" class _TrainerStub: """Minimal stand-in for an SFTTrainer instance, exposing only the attributes that `_prepare_dataset` and `_tokenize` read from `self`.""" _is_vlm = False chat_template = None _tokenize = SFTTrainer._tokenize def __init__(self, tokenizer): self._tokenizer = tokenizer def benchmark(model_name, dataset_name): print(f"Running benchmark for model: {model_name} on dataset: {dataset_name}...") print("Loading dataset...") dataset = load_dataset(dataset_name, split="train", streaming=True).shuffle(seed=SEED).take(N_SAMPLES) print("Loading tokenizer...") tokenizer = AutoTokenizer.from_pretrained(model_name) print("Tokenizing dataset...") config = SFTConfig(max_length=None, bf16=False) tokenized_dataset = SFTTrainer._prepare_dataset( _TrainerStub(tokenizer), dataset, tokenizer, config, packing=False, formatting_func=None, dataset_name="train" ) print("Computing the sequence lengths and total tokens") sequence_lengths = [len(sample["input_ids"]) for sample in tokenized_dataset] total_tokens = sum(sequence_lengths) print("Computing the truncation percentages") truncation_percentages = [] recommended = None for max_len in TRUNCATION_LENGTHS: total_truncated_tokens = sum(max(length - max_len, 0) for length in sequence_lengths) truncation_percentage = total_truncated_tokens / total_tokens * 100 truncation_percentages.append(truncation_percentage) if recommended is None and truncation_percentage < 5.0: recommended = max_len hist = np.histogram(sequence_lengths, bins=50) lengths_distribution = pd.DataFrame({ "max_length": (hist[1][:-1] + hist[1][1:]) / 2, "Percentage (%)": hist[0] / N_SAMPLES * 100, }) truncation_data = pd.DataFrame({ "max_length": [str(x) for x in TRUNCATION_LENGTHS], "Percentage (%)": truncation_percentages, }) return lengths_distribution, truncation_data, CODE_TEMPLATE.format(recommended) with gr.Blocks() as demo: model_input = gr.Textbox(label="Model Name", value="Qwen/Qwen3-0.6B") dataset_input = gr.Textbox(label="Dataset Name", value="trl-lib/tldr") run_button = gr.Button("Run estimation") lengths_plot = gr.BarPlot(None, title="Length distribution", x="max_length", y="Percentage (%)") truncation_percentage_plot = gr.BarPlot( None, title="Truncation percentage (how many tokens are discarded)", x="max_length", y="Percentage (%)", sort=[str(x) for x in TRUNCATION_LENGTHS], ) recommended_code = gr.Code(CODE_TEMPLATE.format("..."), language="python", label="Recommended configuration") run_button.click(fn=benchmark, inputs=[model_input, dataset_input], outputs=[lengths_plot, truncation_percentage_plot, recommended_code]) with gr.Accordion("See details", open=False): gr.Markdown(""" This tool helps you choose an appropriate `max_length` value for your SFT training (`SFTConfig`) by analyzing the tokenized dataset. **How it works:** - Randomly samples 1,000 examples from your dataset. - Prepares and tokenizes the data exactly as `SFTTrainer` would. - Generates two visualizations: - **Sequence Length Distribution:** Shows how long your tokenized sequences are. - **Truncation Percentage:** Estimates the percentage of tokens that would be discarded (truncated) for different `max_length` values. """) demo.launch(server_name="0.0.0.0", server_port=7860)