Practical overview
When it fits
Use it when adapting a PEFT-based Transformers fine-tuning workflow to test or use single-matrix low-rank adapters.
Who it is for
- Developers maintaining model fine-tuning workflows with Hugging Face PEFT and Transformers.
- Practitioners looking to reduce adapter parameter counts compared with standard LoRA.
Documented uses
- Register SingLoRA as an adapter option in a PEFT workflow.
- Configure targeted model layers with a familiar PEFT LoRA configuration.
- Track SingLoRA training steps in a loop using gradient accumulation.
Requirements & limits
The repository is public and licensed under BSD 2-Clause.
- The project reports half the adapter parameters of standard LoRA at the same rank.
- The README specifies Python 3.9+, PyTorch 1.13+, PEFT 0.7+, and Transformers 4.34+.
- The documented workflow registers SingLoRA before using PEFT's
get_peft_model. - Quantized base-model compatibility and adapter merging or unmerging are roadmap items.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Register SingLoRA in a PEFT fine-tuning workflow
Configure a Transformers model with SingLoRA adapters through PEFT.
Before you start
- Python 3.9 or newer
- PyTorch 1.13 or newer, on CPU or CUDA
- PEFT 0.7 or newer
- Transformers 4.34 or newer
Steps
Install the package with the command below.
pip install peft-singloraLoad a model with Transformers and call
setup_singlora()to register the adapter.Create a PEFT
LoraConfigwith a rank and target modules, then pass the model and configuration toget_peft_model.
Expected outcome
A PEFT model configured to use SingLoRA for the targeted linear layers.
Guide limitations
- The README's quick-start snippet is a simplified training-loop example and does not specify supported model names.
- Quantized base-model compatibility is listed as a roadmap item.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- revaldianggara/PEFT-SingLoRA · Official homepage title · retained in its source language

