On this page

How to use LM Studio

Run AI models on your own computer. The app takes minutes to install, and a few settings decide whether it runs well and stays private.

The short version

  1. Check your machine: an Apple Silicon Mac on macOS 14 or newer, or a Windows PC with AVX2 and ideally 16GB of RAM.
  2. Download a model that fits comfortably in your available memory.
  3. Set GPU Offload as high as it will load, and size Context Length to the job.
  4. Turn on Require Authentication before letting anything else on your network use the server.
  1. Your appChat window, editor plugin or script
  2. Local serverlocalhost:1234
  3. Loaded modelHeld in memory
  4. Your hardwareGPU, then CPU
How the pieces fit together. Your apps talk to a local server, which runs a model in your computer's memory.

At a glance

What it is
A desktop app and runtime for local AI models
Runs on
Mac, Windows, Linux
Memory
16GB+ recommended
API address
localhost:1234/v1
API password
Off by default
Offline
Yes, once a model is downloaded

Is LM Studio right for me?

Good fit if

  • You want chats and documents to stay on your own machine
  • You are building against an OpenAI-style API and want a local target
  • You want to compare models on your own hardware
  • You work with unreliable internet, or none at all

Look elsewhere if

  • You need top-tier model quality on a machine with modest memory
  • You use an Intel Mac, which is not supported
  • You want a shared team server without managing tokens and network access
  • You expect private to mean correct: a local model can still be wrong

How do I run my first model?

Four steps, from installing the app to your first answer.

1Install LM Studio

Get it from the official download page and open it. If your computer is older, check the requirements first.

2Download a model

Open the Discover tab, or press Ctrl+2 on Windows and Linux or ⌘+2 on Mac. Pick a curated model or search by name. You can even paste a full Hugging Face URL.

LM Studio window with the Discover tab highlighted in the left sidebar and a curated list called New and Noteworthy.
The Discover tab in the sidebar, highlighted in red by LM Studio's docs. Image: LM Studio docs, retrieved November 2026. The current app may look different.

Which download option? Names like Q4_K_M and Q8_0 are the same model at different levels of compression. Lower numbers mean a smaller file and some loss of quality. LM Studio suggests a 4-bit option or higher if your machine can run it.

3Load it into memory

Go to the Chat tab, open the model loader at the top and select your model. Loading sets aside memory for the model, so this is the step that can fail if the model is too big.

LM Studio model loader bar reading Select a model to load, with an Eject button beside it.
The model loader at the top of the Chat tab. Image: LM Studio docs, retrieved November 2026. The current app may look different.

4Start chatting

LM Studio Chat tab with a model loaded at the top, a short greeting exchange and a message box at the bottom.
A loaded model in the Chat tab. The status bar at the bottom shows how much RAM and CPU it's using. Image: LM Studio docs, retrieved November 2026. The current app may look different.
Watch: Run LLMs Locally with LM Studio: Install, Models, API ServerIndependent tutorial by Tech with Monir, not made by the vendor. Screens may differ from the current version.

What is LM Studio Bionic?

If the website looks different from the tutorials you've seen, this is why. LM Studio now leads with Bionic, its agent for open models.

LM Studio Bionic window with projects on the left, a chat building a website in the middle and a live preview on the right.
Bionic works on documents, code and computer tasks, and shows its work beside the chat. Image: lmstudio.ai, retrieved November 2026. The current app may look different.

LM Studio describes Bionic as natively local, powered by the LM Studio runtime with MLX and llama.cpp underneath. It also offers cloud services, which it says are Zero Data Retention. So check whether you are running a model locally or through their cloud, because that decides where your data goes.

The rest of this guide covers the foundation everything runs on: the runtime, its settings, the local server and the lms command line.

Will it run on my machine?

The hard requirements are short. The real limit is how much memory your chosen model needs.

LM Studio system requirements
PlatformYou needMemoryWatch out for
macOSApple Silicon, macOS 14.0+16GB+ recommendedIntel Macs aren't supported. 8GB Macs may work with small models.
Windowsx64 with AVX2, or Snapdragon X Elite16GB+ RAM, 4GB+ VRAM recommendedOlder x64 CPUs without AVX2 won't run it.
Linuxx64 or ARM64, Ubuntu 20.04+Not statedAppImage only. Ubuntu newer than 22 is "not well tested".
Source: LM Studio system requirements, checked 4 November 2026.

Rule of thumb, not an LM Studio figure: treat a model's file size as the minimum memory it needs, then leave room for context and your other apps. If a model only just fits, choose a smaller one. On a Mac, your browser and editor compete for the same memory.

Which settings matter?

Two sliders explain most complaints about slow or forgetful models. Here's where they are.

LM Studio load settings dialog with sliders for Context Length and GPU Offload, and a Remember settings checkbox above the Load Model button.
1 Context Length and 2 GPU Offload. LM Studio's own magenta markup points to Remember settings at the bottom of the dialog. Tap the image to see all of it. Image: LM Studio docs, retrieved November 2026. The current app may look different.
How to set each one
SettingWhat it controlsHow to choose
GPU OffloadHow much of the model runs on your GPUStart at the maximum. Lower it only if loading fails or the machine becomes unstable.
Context LengthThe model's working memory, in tokensSize it to the job. One token is about ¾ of a word, so 8,192 tokens is roughly 6,000 words. More context uses more memory.
Flash AttentionAn option marked Experimental in this screenshotTest it on your own prompts rather than assuming it helps.

To see this dialog when you load a model, tick the checkbox in the model picker or hold Option.

LM Studio model picker listing three models with a checkbox labeled Manually choose model load parameters highlighted.
The model picker's Manually choose model load parameters checkbox. The circle and arrow are LM Studio's own markup. Tap the image to see all of it. Image: LM Studio docs, retrieved November 2026. The current app may look different.

Save your choices once. Tick Remember settings when you load a model, or set defaults from My Models with the gear icon. LM Studio applies them whenever that model loads, including through lms load.

LM Studio My Models list with a gear icon highlighted beside a model and a tooltip reading Edit model default config.
In My Models, the gear icon opens a model's default settings. The circle and arrow are LM Studio's own markup. Tap the image to see all of it. Image: LM Studio docs, retrieved November 2026. The current app may look different.

How do I use it as an API?

Start the server from the Developer tab or the command line. Existing OpenAI code usually needs only a new base URL.

from openai import OpenAI

# Authentication is off by default, but the OpenAI client still expects a key.
client = OpenAI(base_url="http://localhost:1234/v1", api_key="not-needed-locally")

reply = client.chat.completions.create(
    model="my-model-name",
    messages=[{"role": "user", "content": "Summarize this ticket in one sentence."}],
)
print(reply.choices[0].message.content)

LM Studio also documents an Anthropic-compatible Messages route and its own REST API. For a machine with nobody at the screen, the lms command line covers everything. Run the desktop app at least once first.

lms daemon up        # start the headless daemon
lms get <model>      # search for and download a model
lms load <model> --identifier="my-model-name" --context-length=8192 --gpu=max --ttl 3600
lms server start     # start the API server
lms ps               # see what's loaded
lms log stream       # watch requests and responses

Always set --identifier. It gives your code a stable name, so you can swap the underlying model without changing your application.

Why do models keep reloading?

How a model got into memory decides when it leaves.

Unloading rules by how the model was loaded
Loaded automatically on first requestLoaded with lms load
Idle timeout60 minutes by defaultNone. It stays until you unload it.
Change the timeoutSend "ttl" in seconds with the first requestAdd --ttl <seconds>
Auto-Evict applies?Yes, on by defaultNo
Models kept at onceOne, with Auto-Evict onAs many as you load
Source: LM Studio, Idle TTL and Auto-Evict, checked 4 November 2026.

If two apps ask for different models, Auto-Evict keeps swapping them, and each swap is a full reload. Load both with lms load if you have the memory, or turn Auto-Evict off in the Developer tab's Server Settings.

If your memory seems to have vanished, a model you loaded weeks ago may still be there. lms ps shows it, and lms unload --all clears it.

Example output from LM Studio's docs

$ lms ps

   LOADED MODELS
Identifier: unsloth/deepseek-r1-distill-qwen-1.5b
  • Type:  LLM
  • Path: unsloth/DeepSeek-R1-Distill-Qwen-1.5B-GGUF/DeepSeek-R1-Distill-Qwen-1.5B-Q4_K_M.gguf
  • Size: 1.12 GB
  • Architecture: Qwen2

How do I keep it secure?

Local is only private while the server stays local. By default, the API doesn't ask for a password.

  1. Keep Serve on Local Network off unless another device needs access.
  2. Turn on Require Authentication in Server Settings before enabling network access. This needs LM Studio 0.4.0 or newer.
  3. Create a separate token for each client under Manage Tokens, and copy it straight away. It won't be shown again.
  4. Enable CORS only when a browser app on another origin has to call the server.
  5. Leave Allow calling servers from mcp.json off unless you need it. LM Studio warns it can be a security risk.
LM Studio Server Settings panel with Require Authentication switched on and a Manage Tokens button beneath it.
Server Settings in the Developer tab, with Require Authentication on and Manage Tokens just below. This example also has both MCP options on. Leave Allow calling servers from mcp.json off unless you need it, as step 5 says. Tap the image to see all of it. Image: LM Studio docs, retrieved November 2026. The current app may look different.

Clients then send the header Authorization: Bearer <token>.

Limit what each token can do. When you create one, you can allow or deny MCP access per token, so a client doesn't get more than it needs.

LM Studio Create new permission token dialog with a name field and Allow or Deny choices for two MCP permissions.
Creating a token, with separate permissions for each kind of MCP access. Image: LM Studio docs, retrieved November 2026. The current app may look different.

Can it read my documents?

Yes, .docx, .pdf and .txt files. But short and long files are handled differently, which explains most inconsistent answers.

Does the file fit in context?Depends on Context Length
YesRead in fullThe model sees everything
NoRetrievalOnly the matching sections reach the model
Why the same question can get a thorough answer from a short file and a patchy one from a long file.

Getting better answers from long files: use the words you expect to appear in the passage. "Termination notice period, days, written notice" gives retrieval more to match than "what happens if we leave?" Raising Context Length can also let a file be read in full.

Does it work offline?

Yes, once you have a model. LM Studio says your chats and documents stay on your device.

Works offline

  • Chatting with downloaded models
  • Chatting with documents
  • Running the local server

Needs a connection

  • Searching for models
  • Downloading models
  • Downloading runtimes
  • Checking for app updates

For a machine that must stay offline, you can sideload models. Put the file in ~/.lmstudio/models/<publisher>/<model>/, or try the experimental lms import <path/to/model.gguf>.

Hidden tips

Details that are easy to miss, each with the official page that backs it up.

  • Paste a Hugging Face URL into search

    Discover's search accepts keywords, a user/model string or a full Hugging Face URL.

    Download an LLM
  • A manual load never times out

    Models loaded with lms load have no default timeout. On a shared machine, always pass --ttl.

    Idle TTL and Auto-Evict
  • Set the timeout from your app

    Send "ttl": 300 with the request that triggers a load, and the model unloads after 5 idle minutes. It suits occasional batch jobs.

    Idle TTL and Auto-Evict
  • Saved defaults reach the command line

    Defaults set in My Models also apply to lms load, so a script can inherit a setup you tuned by hand.

    Per-model defaults
  • Limit how much memory auto-loading can use

    "Only Keep Last JIT Loaded Model" and "Auto Unload Unused JIT Models" are separate server switches.

    Server settings
  • Per-request MCP is remote only

    "Allow per-request MCPs" works for that request only, and only with remote servers. Local tools won't work this way.

    Server settings
  • See what your app really sends

    lms log stream shows requests and responses live, so you can tell whether a problem is your prompt, your client or the model.

    lms CLI

LM Studio FAQ

Is LM Studio really private?

LM Studio says what you enter when chatting with a downloaded model, and documents you add, stay on your device. It still makes network requests for model search, downloads, catalog details and update checks. Its cloud services are separate, and it says they are Zero Data Retention. If you enable network serving without authentication, other devices can reach the API.

How much RAM do I need for LM Studio?

LM Studio recommends 16GB or more on macOS and at least 16GB on Windows, plus at least 4GB of dedicated VRAM on Windows. On an 8GB Mac it suggests sticking to smaller models and modest context sizes. What you really need depends on the model.

Does LM Studio work on Intel Macs?

No. The macOS version requires Apple Silicon and macOS 14.0 or newer.

What is LM Studio's default API address?

The docs use http://localhost:1234 in their examples, with OpenAI-compatible routes under /v1, so chat completions are at http://localhost:1234/v1/chat/completions. You can change the port in Server Settings.

Why does my model keep reloading?

With Auto-Evict on, a newly auto-loaded model unloads the previous one, so apps requesting different models keep displacing each other. Load the models with lms load, or turn Auto-Evict off in Server Settings.

Can I run LM Studio without the desktop interface?

Yes. The lms command line includes a headless daemon (lms daemon up) and commands to download models, load them and start the server. The docs say to run LM Studio at least once first.

What is the difference between LM Studio and Bionic?

LM Studio's site describes Bionic as its agent for open models, built for documents, code and computer tasks and powered by the LM Studio runtime. The runtime, local server and lms command line covered here are the foundation it runs on.

Sources

Facts checked 4 November 2026. Products change, so confirm anything important on the official pages.