Quick summary: LM Studio is a desktop app that downloads open-weight language models from Hugging Face and runs them on your own Mac, Windows or Linux computer, with a ChatGPT-style chat window and an optional local API server. Once a model is on your disk, chatting, attaching documents and serving the model to other apps all work without an internet connection. This guide walks through the setup in the order the official docs recommend, explains which download option to pick for your hardware, and shows how to point existing OpenAI-based tools at your own machine.
What's in this guide
- Check your computer before you download anything
- Install LM Studio and get your first model
- Load the model and chat
- Chat with your own documents
- Turn LM Studio into a local API for other apps
- LM Studio vs Ollama vs Jan
- Editor's note, FAQ and related guides
Step 1: Check your computer before you download anything
Local models live in your RAM (and, if you have one, your graphics card's memory), so hardware decides what you can run. LM Studio's system requirements page lists these minimums:
- Mac: Apple Silicon (M1, M2, M3 or M4) on macOS 14.0 or newer. 16GB of RAM or more is recommended; 8GB Macs can work if you stick to smaller models and modest context sizes. Intel Macs are not supported.
- Windows: x64 or ARM (Snapdragon X Elite) PCs. On x64 the CPU must support the AVX2 instruction set. At least 16GB of RAM and at least 4GB of dedicated VRAM are recommended.
- Linux: x64 or ARM64, distributed as an AppImage, Ubuntu 20.04 or newer. The docs note that Ubuntu versions newer than 22 are not well tested.
If your machine falls short of the recommended RAM, LM Studio may still install, but you'll be limited to small models. That's worth knowing before you spend twenty minutes downloading a multi-gigabyte file that won't load.
Step 2: Install LM Studio and get your first model
Install the app
Download the installer for your operating system from the official download page (lmstudio.ai/download). At the time of writing, the page offered LM Studio version 0.4.26, available under LM Studio's terms of use. The same page also promotes LM Studio Bionic, which is a separate, newer agent app from the same company; for this tutorial you want the regular LM Studio download, described on the page as "Experiment with LLMs on your computer. Chat interface and programmable API."
Find a model in the Discover tab
LM Studio has a built-in downloader that pulls supported models from Hugging Face. Open the Discover tab (shortcut: Cmd+2 on Mac, Ctrl+2 on Windows and Linux). You can pick one of the curated options or search in three ways:
- by keyword, such as
llama,gemmaorqwen; - by a specific
user/modelstring from Hugging Face; - by pasting a full Hugging Face URL into the search bar.
Pick the right download option
Most models show several files with names like Q3_K_S, Q4_K_M or Q8_0. These are all the same model compressed to different degrees, a technique called quantization. Smaller numbers mean smaller files and lower memory use, at the cost of some quality. The official guidance is short: choose a 4-bit option or higher if your machine can handle it. In practice, a Q4 file is the usual starting point, and you move up to Q6 or Q8 only if you have memory to spare.
LM Studio runs GGUF models through llama.cpp on all three platforms, and on Apple Silicon Macs it can also run MLX models. If you're on a Mac, you may see both formats for the same model.
Step 3: Load the model and chat
Downloading a model only puts it on your disk. To use it, you load it into memory:
- Go to the Chat tab.
- Open the model loader (
Cmd+Lon Mac,Ctrl+Lon Windows and Linux). - Select the model you downloaded.
- Optionally, adjust load settings before it loads, such as GPU offload and context size.
Once it's loaded, type a message and the conversation runs entirely on your computer. New chats are Cmd+N / Ctrl+N, and you can organise conversations into folders (Cmd+Shift+N / Ctrl+Shift+N) and drag chats between them. Conversations are saved as JSON files in ~/.lmstudio/conversations/ on Mac and Linux, or %USERPROFILE%\.lmstudio\conversations on Windows.
Save load settings per model
If a model only fits with a particular GPU offload or context length, you don't have to set it every time. In the My Models tab, click the gear icon next to a model to set its default load parameters. The docs mention three common reasons to do this: a specific GPU offload level, a specific context size, and whether to use Flash Attention. Those defaults apply wherever the model is loaded, including from the command line.
Reuse prompts with Presets
Presets bundle a system prompt with inference settings such as Temperature, Top P and Max Tokens. If you use the same model for, say, email drafts and code review, save each setup as a Preset and switch between them instead of rewriting the system prompt. Presets are plain JSON files, stored in ~/.lmstudio/config-presets (Mac/Linux) or %USERPROFILE%\.lmstudio\config-presets (Windows).
Step 4: Chat with your own documents
You can attach .docx, .pdf and .txt files to a chat. What happens next depends on length:
- If the document fits in the model's context window, LM Studio adds the whole file to the conversation.
- If it's too long, LM Studio switches to retrieval-augmented generation (RAG): it tries to pull out only the relevant passages and hands those to the model.
LM Studio's offline documentation states that dropped-in documents stay on your machine and all document processing is done locally. That makes this the feature most people install LM Studio for: summarising a contract, a lab report or meeting notes you'd rather not upload to a cloud chatbot.
The docs are candid that RAG "sometimes requires some tuning and experimentation." Their one concrete tip is to put as much context in your question as possible, including the terms and phrases you expect to appear in the relevant part of the document. Asking "What does section 4 say about the termination notice period?" will usually retrieve better passages than "Summarise this."
Step 5: Turn LM Studio into a local API for other apps
This is where LM Studio becomes more than a chat window. It can serve a loaded model on OpenAI-compatible endpoints, so tools built for the OpenAI API can talk to your own computer instead.
- Open the Developer tab and switch the server toggle on. The status shows as running, along with the address it is reachable at.
- Or start it from a terminal with
lms server start(and stop it withlms server stop). Thelmscommand-line tool ships with LM Studio, but you need to open the app at least once before it works. - In your client code, change the base URL. The official examples assume port 1234, so a Python OpenAI client becomes
OpenAI(base_url="http://localhost:1234/v1"), and themodelfield takes the model identifier shown in LM Studio.
The OpenAI-compatible endpoints listed in the docs are /v1/models, /v1/responses, /v1/chat/completions, /v1/embeddings and /v1/completions, plus an LM Studio-specific /v1/decisions. The docs also list Anthropic-compatible endpoints and say Codex works through the /v1/responses endpoint.
Server settings worth knowing
- Just-in-Time model loading is on by default. Apps can request any downloaded model and LM Studio loads it on demand, so
/v1/modelslists all downloaded models, not just loaded ones. - Idle TTL unloads a JIT-loaded model after it sits unused; the default is 60 minutes, and you can set a different value per request with a
ttlfield. - Auto-Evict (on by default) unloads the previous JIT-loaded model before loading a new one, so switching models from a client app doesn't pile them up in memory.
- Serve on Local Network lets other devices on your network use the server, and Require Authentication makes clients send an API token. Turn on the second whenever you turn on the first.
LM Studio vs Ollama vs Jan
All three run open models locally, but they differ in interface, licensing and how they make money. The table below uses only what each official site states today.
| LM Studio | Ollama | Jan | |
|---|---|---|---|
| Local use | Desktop app download; no price listed for the app. Terms allow personal and internal business use. | Free plan; the pricing FAQ says running models on your own hardware is always unlimited. | Desktop app described as free and open source (Apache 2.0). |
| Paid options | Pricing page covers the separate Bionic app: Bionic+ $20/month and Pro $100/month for US-hosted cloud models. | Pro $20/month ($200/year) with $60 of cloud usage credits; Max $100/month with $300 of credits. | None listed on the Jan Desktop pages checked. |
| Main interface | GUI with Discover, Chat, Developer and My Models tabs, plus the lms CLI. |
Installed via a one-line script or manual download; runs models from the command line. | Desktop app with projects, assistants, web search and file upload. |
| API / cloud | OpenAI- and Anthropic-compatible endpoints, default port 1234 in the docs. | Runs models locally or in Ollama's cloud; cloud model names end in :cloud. |
Local OpenAI-compatible API server. |
| Best fit | People who want to browse, compare and tune models visually. | Developers who live in the terminal or want a cloud fallback. | People who want a fully open-source chat app. |
If you already tried Ollama and found the command line awkward, LM Studio is the natural next step: same idea, but you can see the download options, file sizes and load settings before you commit.
Editor's note
Good for: anyone who wants a private assistant for sensitive documents, developers who want to test OpenAI-style code against a free local model before paying for API calls, and people who travel or work offline.
Not for: Intel Mac owners (not supported), PCs whose x64 CPU lacks AVX2, or anyone expecting cloud-chatbot quality from a small model on an 8GB laptop.
Gotchas I found in the docs:
- Two apps, one company. The download and pricing pages lead with LM Studio Bionic. The paid plans you see there are for Bionic's cloud models, not for running local models in regular LM Studio.
- Offline has limits. Searching the Discover tab, downloading models or runtimes, and checking for updates all need internet. Download what you need before you go offline.
- Linux updates are manual. The offline docs say the in-app updater covers macOS and Windows, while the Linux updater is still in the works.
- Memory creep from other apps. With JIT loading on, a connected app can load models in the background. Lower the Idle TTL if your machine slows down after using editor plugins.
Common errors and fixes:
- Model won't load or the computer freezes: pick a smaller quantization (a lower Q number) or a smaller model, and reduce the context size in the load settings.
lmscommand not found or not working: open the LM Studio app at least once, as the CLI docs require.- Document answers miss the point: the file was probably too long and went through RAG. Ask with specific terms from the document, or split it into smaller files.
- Another device can't reach the server: turn on Serve on Local Network in Server Settings, and use the port shown in the Developer tab.
For a visual reference, see the official LM Studio screenshots at the end of this post.
FAQ
Does LM Studio send my chats to the cloud?
Not for local models. LM Studio's offline documentation says that once a model is on your machine, nothing you enter while chatting leaves your device, and attached documents are processed locally. Internet access is only needed for searching and downloading models, downloading runtimes and checking for app updates.
Can I use LM Studio at work?
The LM Studio desktop app's terms (version dated August 23, 2026) grant a license for "personal and / or internal business purposes." They also restrict things like reselling the software or offering it as a service, so read the terms if you plan anything beyond internal use.
Which model should I download first?
Start small. A model with a few billion parameters at a 4-bit quantization (a Q4 file) loads quickly on most 16GB machines and lets you confirm everything works. Once you know how your hardware behaves, try a larger model or a higher quantization.
Related guides on lightmind24
- Ollama Not Working? Fixes for Common Errors and GPU Issues
- How to Run Open AI Models on Your Own Windows 11 PC with Llama Windows
- ComfyUI Errors Fixed: Custom Nodes, Missing Models, VRAM
Download one small model, attach a document you'd never paste into a cloud chatbot, and you'll know in ten minutes whether local AI earns a place on your computer.
Images: official screenshots from the LM Studio documentation (lmstudio.ai/docs), included at the end of this post.
Last verified: 2026-10-26
Sources:
LM Studio Docs: Welcome
LM Studio Docs: System Requirements
LM Studio Docs: Get started
LM Studio Docs: Download an LLM
LM Studio Docs: Manage chats
LM Studio Docs: Chat with Documents
LM Studio Docs: Offline Operation
LM Studio Docs: Per-model Defaults
LM Studio Docs: Presets
LM Studio Docs: Local Server
LM Studio Docs: Server Settings
LM Studio Docs: Idle TTL and Auto-Evict
LM Studio Docs: OpenAI Compatibility
LM Studio Docs: lms CLI
LM Studio download page
LM Studio (Bionic) pricing
LM Studio Desktop App Terms of Service
Ollama pricing
Ollama download
Jan Docs: Overview
댓글
댓글 쓰기