LM Studio: «Failed to load model» — почему не удалось загрузить модель
Разбор ошибки Failed to load model в LM Studio по строке в логе: unknown model architecture (старый движок), нехватка памяти и слишком длинный контекст, защита от перегрузки, битый или недокачанный GGUF, модель не в том формате. Что проверить и в каком порядке.
Красная плашка «Failed to load model» в LM Studio — это обёртка. Она означает только «движок не смог открыть файл». Настоящая причина написана строкой ниже или в логе, и от неё зависит, что делать. Без этой строки можно долго подбирать контекст, когда на деле просто устарел движок.
Где смотреть настоящую ошибку
Раскрой текст ошибки в самой плашке или открой лог: в режиме разработчика (вкладка
Developer) есть журнал сервера. Ищи строки, которые начинаются с llama_model_load: или
llama_model_loader:, и строки с error. Дальше — по тексту.
unknown model architecture
error loading model architecture: unknown model architecture: 'gemma4'
Вместо gemma4 может стоять qwen3next, glm4moe, deepseek2 или любое другое имя. Файл
модели в порядке, но движок не знает такую архитектуру. Поддержка новой модели сначала
появляется в llama.cpp, потом в движке LM Studio. Свежие модели часто опережают установленную
у тебя версию.
Что делать:
- Обнови LM Studio до последней версии.
- Открой настройки → Runtime и обнови движок llama.cpp (CUDA, Vulkan или CPU, какой у тебя выбран). Движки обновляются отдельно от приложения.
- Если модель вышла несколько дней назад, поддержки может ещё не быть нигде. Подожди обновления или возьми предыдущее поколение модели.
Не хватает памяти
Самая частая причина, если архитектура знакомая. Модели нужна память под сами веса и под кэш контекста, а он растёт с длиной контекста. Модель на 8B в Q4 весит около 5 ГБ, но с контекстом на 128 тысяч токенов ей понадобится в разы больше.
Порядок действий:
- Уменьши Context Length в параметрах загрузки. Для начала поставь 8192: этого хватает для большинства диалогов.
- Уменьши GPU Offload, если модель не влезает в видеопамять. Часть слоёв уйдёт на процессор, станет медленнее, зато загрузится.
- Возьми квантизацию легче:
Q4_K_MвместоQ8_0илиQ6_K. Обозначения разобраны в статье про формат GGUF. - Закрой то, что занимает память: браузер, вторую загруженную модель, игры.
У LM Studio есть защита от перегрузки системы: модель, которая по оценке не поместится в память, программа откажется загружать, чтобы компьютер не завис. Порог настраивается в параметрах приложения. Ослаблять его стоит, только если ты понимаешь, сколько памяти реально свободно: при нехватке система начнёт сбрасывать память на диск и перестанет отвечать.
Файл недокачан или битый
Если загрузка обрывалась, файл GGUF может быть неполным. Признаки — в логе ошибки про
неожиданный конец файла, неверный размер тензора или failed to read. Удали модель на
вкладке My Models и скачай заново. Если качал вручную, сравни размер с указанным на
странице модели на Hugging Face.
Не тот формат
LM Studio загружает GGUF через llama.cpp, а на Mac ещё MLX. Файлы .safetensors из
обычного репозитория модели, .bin или .pth она напрямую не откроет: нужна GGUF-версия,
обычно в соседнем репозитории с припиской -GGUF. Модели MLX на Windows не запустятся.
Если модель разбита на части (-00001-of-00003.gguf), все части должны лежать в одной папке.
Мультимодальной модели для работы с картинками нужен ещё файл проектора mmproj. Без него
текст работает, а изображения — нет.
Быстрая шпаргалка
| Что в логе | Причина | Решение |
|---|---|---|
unknown model architecture | движок старше модели | обновить LM Studio и движок во вкладке Runtime |
failed to allocate, out of memory | не хватило RAM или VRAM | контекст меньше, GPU Offload меньше, квантизация легче |
failed to read, unexpected end of file | файл битый или неполный | скачать заново |
ничего внятного, модель .safetensors | не тот формат | найти GGUF-версию |
Если модель загрузилась, но работает медленно, проверь, считает ли она на видеокарте: это разобрано в статье LM Studio не видит видеокарту.
Чтобы не подбирать вручную
Почти все ошибки выше — следствие того, что модель и её параметры выбраны вручную, наугад. Дока при установке сама подбирает модель и квантизацию под объём памяти и видеокарту, поэтому локальный агент запускается без этих шагов. Свои GGUF-файлы туда тоже можно загрузить через экран «Модели», а прикинуть, что потянет железо, — в калькуляторе подбора модели.