К содержимому
Другое

Qwen2.5-Coder-3B NFL Text-to-SQL LoRA

генерация SQL-запросов для статистики NFL

2 мин чтенияобновлено

Эта модель представляет собой LoRA-адаптер (компактную надстройку для дообучения без изменения весов всей нейросети), который переводит вопросы на естественном языке в PostgreSQL-запросы к базе данных по американскому футболу (схема nfl). Адаптер создан автором sonnyhuang на базе квантованной модели mlx-community/Qwen2.5-Coder-3B-Instruct-8bit для работы через фреймворк MLX. В отличие от базовой модели, он заточен под конкретную структуру таблиц проекта NFL Text-to-SQL Agent и обучался с проверкой выполнения каждого сгенерированного запроса. Решение пригодится разработчикам, запускающим локальных SQL-агентов на компьютерах Apple Silicon.

Ключевые особенности

  • Адаптер собран под библиотеку mlx для локального запуска на устройствах Apple Silicon с использованием 8-битной базы Qwen2.5-Coder-3B.
  • Обучение проведено методом LoRA с рангом 16 для всех слоёв внимания (attention) и MLP в верхних 16 блоках модели.
  • Модель тренировалась одну эпоху на 3 400 синтетических примерах, каждый из которых предварительно проверялся выполнением в реальной базе данных.
  • Функция потерь при обучении рассчитывалась исключительно на самой SQL-генерации (SQL completion), чтобы модель фокусировалась на точности кода.

Что можно сделать

  • Встроить адаптер в локального чат-бота для аналитики матчей и статистики игроков NFL по готовой схеме nfl из проекта NFL Text-to-SQL Agent.
  • Объединить модель с RAG (поиском по контексту и документации), чтобы повысить точность генерации запросов на нестандартных вопросах.
  • Использовать как референс для создания собственных компактных Text-to-SQL агентов на базе Qwen2.5-Coder под локальные базы PostgreSQL.

Пример

from mlx_lm import load

model, tokenizer = load(
    "mlx-community/Qwen2.5-Coder-3B-Instruct-8bit",
    adapter_path=""
)
ПодробнееТочность выполнения (execution accuracy): 94.5% на отложенных шаблонных вопросах (98.2% в связке с RAG) и 63.4% на вопросах, написанных вручную (67.0% с RAG).
Формат промптов: требуется системный промпт и компактное описание схемы базы по шаблону проекта (src/nflsql/agent/prompts.py).
Лицензия: Qwen Research License Agreement — разрешено только некоммерческое использование (исследования и тестирование); датасет основан на nflverse (CC BY 4.0).
Обсудить Telegram 0

Запустится ли?

Запустится в U32

Влезает без сжатия.

  • U32веса 5.8 GB · готовые файлы6.9 GB
  • FP8 / INT8рекомендуемвеса 2.9 GB3.7 GB
  • 4-bitвеса 1.7 GB2.3 GB

Совет: берите 8-bit.FP8 / INT8 почти не отличается по качеству от полной точности (разница в пределах процента), а памяти занимает вдвое меньше и на RTX 40/50, H100 работает быстрее. Полную точность есть смысл брать только для дообучения.

Что взять под эту модель

Massed ComputeОткрыть Massed Compute

Своя видеокарта: FP8 / INT8 — от RTX 2060 · U32 — от RTX 5060 Ti 8GB

Почасовые цены Massed Compute на ноябрь 2026. Цена со скидкой — с промокодом при оплате.

Это LoRA: вместе с базовой моделью Qwen2.5-Coder-3B-Instruct-8bit.

Оценка: веса плюс рабочая память. Длинные ролики, высокое разрешение и большой контекст требуют больше.

Запуск на Massed Compute

Скрипт скачает модель на арендованную машину. Как её запустить — в карточке модели.

  1. 1. Арендуйте машину с подходящей видеокартой

    Открыть Massed Compute
  2. 2. Вставьте скрипт в терминал машины

    Подключитесь по SSH (команда есть в панели Massed Compute) или откройте терминал на рабочем столе машины.

    HF_TOKEN / CIVITAI_TOKENВ начале скрипта строки для токенов: вставьте свой между кавычками. Токен Hugging Face нужен для закрытых моделей, токен Civitai — для моделей с Civitai.

    # sonnyhuang/qwen2.5-coder-3b-nflsql-lora
    # ===== Токены: вставьте свои между кавычками =====
    export HF_TOKEN=""        # huggingface.co/settings/tokens — для закрытых моделей
    # ==========================================
    mkdir -p ~/models
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source "$HOME/.local/bin/env"
    uv tool install "huggingface_hub[cli]"
    hf download mlx-community/Qwen2.5-Coder-3B-Instruct-8bit --local-dir ~/models/Qwen2.5-Coder-3B-Instruct-8bit
    hf download sonnyhuang/qwen2.5-coder-3b-nflsql-lora --local-dir ~/models/qwen2.5-coder-3b-nflsql-lora
    # Модель в папке ~/models. Как её запускать, написано в карточке модели (ссылка выше).
    Добавить ещё LoRA к Qwen2.5-Coder-3B-Instruct-8bit
  3. 3. Пользуйтесь

    Модель в папке ~/models. Как её запускать, написано в карточке модели (ссылка выше).

Не забудьте остановить машину в панели, когда закончите: оплата идёт поминутно, пока она включена.

Как ускорить

Подобрано под тип модели. Выберите своё железо в блоке выше — покажем то, что подходит именно вам.

  • FlashAttention 44.0.0b40от 18 ноября 2026новая версия

    самое быстрое точное внимание на B200

    Ядра для Blackwell (пока бета). Точное внимание без квантования — подходит для всего, включая LLM.

    Как включить: pip install flash-attn-4; vLLM и SGLang подхватывают сами.

    Предыдущие поколения (2)
    • FlashAttention 3 — Версия для Hopper (H100/H200) с FP8.
    • FlashAttention 2 — Стандарт для RTX 30/40/50 и A100: точное внимание без лишней памяти на длинных контекстах.
  • torch.compile2.15.0от 28 октября 2026новая версия

    10–30% бесплатно

    Компилирует модель под вашу видеокарту. Первый запуск дольше, дальше быстрее.

    Как включить: model = torch.compile(model); в ComfyUI — узел TorchCompileModel.

Семья модели

Нужна базовая модель

mlx-community/Qwen2.5-Coder-3B-Instruct-8bit

Эта модель — LoRA / адаптер. Сначала скачайте базовую модель, затем подключите к ней эту.

  1. Qwen2.5-3Bоснова семьи
  2. Qwen2.5-Coder-3B
  3. Qwen2.5-Coder-3B-Instruct
  4. Qwen2.5-Coder-3B-Instruct-8bit
  5. qwen2.5-coder-3b-nflsql-lora

Новые посты про версии Qwen2.5-3B — сжатые, дообучения, LoRA — появятся в колокольчике.

Сжатые версии 12Все на Hugging Face
Дообучения 12Все на Hugging Face
LoRA и адаптеры 2Все на Hugging Face
Слияния 3Все на Hugging Face

О модели

sonnyhuang/qwen2.5-coder-3b-nflsql-lora
Автор
sonnyhuang
Категория
Другое
Дата выхода
На сайте

На сайте

Hugging Face

00

Спросить нейросеть об этой модели

Отвечает Gemini 4 · переписка хранится только в этой вкладке

Комментарии