stack-edu-classifier-ruby
This is a classifier for scoring the educational value of code files in The Stack v2 dataset, it is a finetuned version of
bigcode/starencoder with a classification head on code files annotated by Llama3.1-70B-Instruct. We use this classifier for building Stack-Edu dataset used for training SmolLM2, see
paper. Each classifier is trained on one programming language.
How to use in transformers
To load the classifier, use the following code:
1from transformers import AutoTokenizer, AutoModelForSequenceClassification
2
3tokenizer = AutoTokenizer.from_pretrained(REPO_NAME)
4model = AutoModelForSequenceClassification.from_pretrained(REPO_NAME)
5
6text = "This is a test sentence."
7inputs = tokenizer(text, return_tensors="pt", padding="longest", truncation=True)
8outputs = model(**inputs)
9logits = outputs.logits.squeeze(-1).float().detach().numpy()
10score = logits.item()
11result = {
12 "text": text,
13 "score": score,
14 "int_score": int(round(max(0, min(score, 5)))),
15}
16
17print(result)
18# {'text': 'This is a test sentence.', 'score': 0.07964489609003067, 'int_score': 0}
Intended uses & limitations
While the classifier performs well in distinguishing high-quality code in its target language (Ruby in this case), there are some limitations:
- Scope: The model's performance might change for other datasets, in particular for out of distribution samples. The classifier's context is 1024 tokens, which might not be sufficient to assess the quality of some long code files.
- Bias: The model's performance is dependent on the quality and representativeness of the training data and the LLM used for the annotation. Biases in both can affect the classifier's judgments. It might overfit to thoroughly commented code.
- Context: The classifier evaluates individual code files without considering broader context, which might impact its effectiveness in certain scenarios.
Training procedure
The classifier was trained on 500,000 pairs of code files and their scores from 0 to 5, generated by Llama3.1. The samples were annotated based on their educational quality with 1 being not educational and 5 being highly educational and relevant for teaching programming. You can find the prompt used for building the annotations in the appendix of
SmolLM2 paper.
We added a classification head with a single regression output to StarEncoder and trained the model for 20 epochs with a learning rate of 3e-4. During training, the embedding and encoder layers were frozen to focus on the classification head.
It achieves the following results on the evaluation set:
- Loss: 0.3282
- Precision: 0.4623
- Recall: 0.3260
- F1 Macro: 0.3536
- Accuracy: 0.6657
- F1 Binary Minimum3: 0.6101
While the macro F1 scores across the 1-5 rating scale are relatively low due to the model's difficulty in distinguishing between higher-rated samples, the classifier performs well for our primary filtering task. When converting to binary classification, using a threshold of 2 achieves the F1 scores ranges between 0.8 and 0.9 for most Stack-Edu classifiers, whereas a threshold of 3 yields F1 scores between 0.55 and 0.70. With the Highest being Python, C, Rust and the lowest being TypeScript and PHP.
We validated these classifiers by filtering Stack v2 data and testing on an intermediate SmolLM2 checkpoint. Filtering with a threshold of 3 improved performance across most languages while maintaining adequate data volume, though Java showed better results with a threshold of 2.
Training hyperparameters
The following hyperparameters were used during training:
- learning_rate: 0.0003
- train_batch_size: 64
- eval_batch_size: 256
- seed: 0
- distributed_type: multi-GPU
- num_devices: 2
- total_train_batch_size: 128
- total_eval_batch_size: 512
- optimizer: Adam with betas=(0.9,0.999) and epsilon=1e-08
- lr_scheduler_type: linear
- lr_scheduler_warmup_steps: 200
- num_epochs: 20
License
Citation
1@misc{allal2025smollm2smolgoesbig,
2 title={SmolLM2: When Smol Goes Big -- Data-Centric Training of a Small Language Model},
3 author={Loubna Ben Allal and Anton Lozhkov and Elie Bakouch and Gabriel Martín Blázquez and Guilherme Penedo and Lewis Tunstall and Andrés Marafioti and Hynek Kydlíček and Agustín Piqueres Lajarín and Vaibhav Srivastav and Joshua Lochner and Caleb Fahlgren and Xuan-Son Nguyen and Clémentine Fourrier and Ben Burtenshaw and Hugo Larcher and Haojun Zhao and Cyril Zakka and Mathieu Morlon and Colin Raffel and Leandro von Werra and Thomas Wolf},
4 year={2025},
5 eprint={2502.02737},
6 archivePrefix={arXiv},
7 primaryClass={cs.CL},
8 url={https://arxiv.org/abs/2502.02737},
9}
