debug-lm-studio-model-load

Diagnose and resolve stuck JIT model loading in LM Studio on macOS.

1|Updated Mar 15, 2025
One-click install
npx skills add https://github.com/adikpb/dotfiles --skill debug-lm-studio-model-load-adikpb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug-lm-studio-model-load
Source: https://github.com/adikpb/dotfiles/tree/main/.hermes/skills/lm-studio/debug-lm-studio-model-load
Command: npx skills add https://github.com/adikpb/dotfiles --skill debug-lm-studio-model-load-adikpb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? LM Studio's model listing API can respond normally while chat completions time out indefinitely, leaving you unsure whether the model is stuck loading or just busy. This Skill provides a systematic diagnostic workflow to distinguish a stuck JIT load from normal processing and recover without guesswork. ## Core Features & Use Cases - Symptom-Based Diagnosis: Compare /v1/models response speed, worker process CPU patterns, and memory pressure to pinpoint whether the JIT loader is stuck in a Metal kernel wait. - Stuck vs. Busy Differentiation: A decision table separates a hung loader (flat ~45% CPU for 5+ minutes) from a busy inference queue (pulsing CPU), preventing counterproductive restarts or duplicate requests. - Known Pitfall Coverage: Documents Qwen3.5 thinking models returning empty content at low max_tokens, and OptiQ mixed-precision MLX builds failing to load in LM Studio. - Use Case: Your agent's LLM calls to LM Studio suddenly time out. Run the inspection commands to check worker CPU and memory, confirm a stuck JIT load, then fully quit and relaunch LM Studio with only the needed model loaded. ## Quick Start Ask the agent to diagnose why LM Studio chat completions are timing out while the models endpoint still responds.

Frequently Asked Questions about debug-lm-studio-model-load

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix LM Studio chat completions timing out?▼

First confirm the models endpoint responds fast while completions hang, then check the llmworker process for sustained 40-50% CPU. If stuck, fully quit LM Studio with Cmd+Q, reopen it, load only the needed model, and wait for Ready status before sending requests.

How to tell if LM Studio is stuck loading or busy processing?▼

A stuck JIT load shows flat 40-50% worker CPU for 5+ minutes with no response, while busy processing shows pulsing CPU between 30-70%. If busy, send one request at a time with a long timeout instead of restarting.

Why does Qwen3.5 return empty content in LM Studio?▼

Qwen3.5 MLX builds run in persistent thinking mode and put output in reasoning_content when max_tokens is low, leaving content empty. Re-test with max_tokens of 512 or higher before concluding the model is broken.

Does LM Studio support OptiQ mixed-precision MLX models?▼

No, LM Studio's MLX loader only handles uniform affine quantization and rejects OptiQ per-layer 8/4-bit builds with a Failed to load model error. These models require the separate mlx-optiq runtime served on a side port as a custom provider.

Why does /v1/models respond but the model is not loaded?▼

LM Studio registers all available models in /v1/models at startup regardless of load state. Models only load on the first inference call via JIT loading, so a fast models response never indicates the model is ready.