fine-tuning-peft — скилл для Claude Code: LoRA и QLoRA для LLM
Скилл для дообучения больших языковых моделей через LoRA, QLoRA и другие адаптерные методы, когда видеопамяти мало.
npx claude-code-templates@latest --skill ai-research/fine-tuning-peftЧто делает fine-tuning-peft
Скилл объясняет и показывает, как дообучить модель на 7B–70B, обновляя меньше 1% весов. В основе — библиотека PEFT от HuggingFace, которая работает вместе с transformers. Адаптер весит мегабайты, а не гигабайты, поэтому хранить несколько вариантов под разные задачи дешевле, чем копии всей модели.
Внутри — готовые примеры кода: обычный LoRA с LoraConfig, QLoRA с 4-битной квантизацией через BitsAndBytesConfig, загрузка и слияние адаптеров, подбор ранга и lora_alpha, списки целевых модулей для Llama, Mistral, Qwen, GPT-2, Falcon и BLOOM. Есть таблица с рангами от 4 до 64 и совет начать с 8 или 16.
Понадобятся peft>=0.13.0, transformers>=4.45.0, torch>=2.0.0 и bitsandbytes>=0.43.0 — без последнего квантизация не заработает. QLoRA рассчитана на одну видеокарту с 24 ГБ, но за это платят примерно 5% качества по сравнению с полным дообучением. Для моделей меньше 1B и при большом сдвиге домена авторы советуют полное дообучение.
Какие задачи решает
- дообучить модель на 70B, уложившись в одну видеокарту
- сохранить адаптер на несколько мегабайт вместо копии всей модели
- подобрать ранг и alpha под конкретную задачу
- собрать несколько адаптеров под разные задачи на одной базовой модели
- слить обученный адаптер с базовой моделью перед выкладкой
Примеры запросов агенту
- Настрой LoRA для
meta-llama/Llama-3.1-8Bс рангом 16 и сохрани только адаптер - Покажи конфиг QLoRA на 4 бита, чтобы 70B влезла в 24 ГБ видеопамяти
- Как слить адаптер из
./lora-llama-adapterс базовой моделью?
Как установить fine-tuning-peft
1Через claude-code-templates
npx claude-code-templates@latest --skill ai-research/fine-tuning-peft2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill fine-tuning-peft -a claude-code3Вручную: положить файлы
~/.claude/skills/fine-tuning-peft/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/fine-tuning-peft/
Вручную: положить файлы
.agents/skills/fine-tuning-peft/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/fine-tuning-peft/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates fine-tuning-peft2Вручную: положить файлы
.github/skills/fine-tuning-peft/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/ai-research/fine-tuning-peftВручную: положить файлы
.devin/skills/fine-tuning-peft/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о fine-tuning-peft
Как установить fine-tuning-peft в Claude Code?
Через шаблоны: npx claude-code-templates@latest --skill ai-research/fine-tuning-peft. Второй способ — npx skills add davila7/claude-code-templates --skill fine-tuning-peft -a claude-code. Файл скилла окажется в ~/.claude/skills/fine-tuning-peft/SKILL.md.
Что делает fine-tuning-peft?
Помогает дообучать LLM адаптерными методами: LoRA, QLoRA и ещё больше двадцати вариантов. Скилл даёт конфиги, примеры обучения и загрузки адаптеров на базе библиотеки PEFT.
Чем QLoRA отличается от обычной LoRA?
QLoRA добавляет 4-битную квантизацию базовой модели, поэтому 70B помещается на одну видеокарту с 24 ГБ. Взамен качество проседает примерно на 5% относительно полного дообучения.