Module 3: LM Studio - Introduction

Installing LM Studio

Next →

Capsule overview

First practical step: install LM Studio on your machine (Mac, Windows, or Linux).

The process is simple (5-10 minutes):

  1. Download the installer
  2. Install the application
  3. First run
  4. Verify it works

Time: 15 minutes
Difficulty: Very low

🎯 Objectives

  • ✅ Download LM Studio for your OS
  • ✅ Install it correctly
  • ✅ Open the application (first time)
  • ✅ Basic interface tour

💻 Step 1: Check the Requirements

Compatible operating system:

OSMinimum VersionRecommended
macOS11 Big Sur13 Ventura+
Windows10 (64-bit)11
LinuxUbuntu 20.04+Ubuntu 22.04+

Disk space:

# macOS/Linux
df -h ~

# Windows
wmic logicaldisk get size,freespace,caption

You need: A minimum of 10GB free (20GB+ recommended)

📥 Step 2: Download LM Studio

2.1 Visit the official site:

https://lmstudio.ai/

2.2 Download for your OS:

macOS:

  • Click "Download for Mac"
  • File: LM-Studio-<version>.dmg (~200MB)
  • Apple Silicon (M1/M2/M3): Native ARM version
  • Intel: x86_64 version

Windows:

  • Click "Download for Windows"
  • File: LM-Studio-<version>.exe (~180MB)

Linux:

  • Click "Download for Linux"
  • File: LM-Studio-<version>.AppImage (~190MB)

Download time: 2-10 minutes (depending on your internet)

📦 Step 3: Installation

macOS:

  1. Open the downloaded .dmg file
  2. Drag LM Studio.app to the Applications folder
  3. First time: Right-click → "Open" (bypass Gatekeeper)
  4. Confirm "Open" in the security dialog

If you see the error "App is damaged":

xattr -cr /Applications/LM\ Studio.app

Windows:

  1. Run the .exe installer
  2. Click "Next" in the wizard
  3. Choose the installation directory (default is fine)
  4. Click "Install"
  5. Wait 1-2 minutes
  6. Click "Finish"

Shortcut: Desktop + Start Menu automatically

Linux (AppImage):

# 1. Move it to an appropriate directory
mv ~/Downloads/LM-Studio-*.AppImage ~/Applications/

# 2. Grant execution permissions
chmod +x ~/Applications/LM-Studio-*.AppImage

# 3. Run it
~/Applications/LM-Studio-*.AppImage

Optional: Desktop entry

cat > ~/.local/share/applications/lmstudio.desktop <<EOF
[Desktop Entry]
Type=Application
Name=LM Studio
Exec=/home/$USER/Applications/LM-Studio-*.AppImage
Icon=lmstudio
Terminal=false
Categories=Development;
EOF

🚀 Step 4: First Run

4.1 Open LM Studio:

macOS: Applications → LM Studio
Windows: Start Menu → LM Studio
Linux: Run the AppImage

4.2 Welcome screen:

The first time, you'll see:

┌─────────────────────────────────────────┐
│                                         │
│         Welcome to LM Studio           │
│                                         │
│   Run LLMs locally on your machine     │
│                                         │
│         [Get Started]                   │
│                                         │
└─────────────────────────────────────────┘

Click "Get Started"

4.3 Initial setup:

Analytics: (Optional)

  • LM Studio asks whether to send anonymous analytics
  • Choose "Allow" or "Don't Allow" (it doesn't affect functionality)

Model Storage: (Important)

  • LM Studio asks where to store models
  • Default: ~/lm-studio/models/ (fine for most people)
  • If you have an external drive: You can change it here

Recommendation: Use the default (you can change it later in Settings)

🖥️ Step 5: Interface Tour

Main screen (UI Overview):

┌──────────────────────────────────────────────────────────┐
│  [🏠 Home]  [🔍 Discover]  [💬 Chat]  [⚙️ Settings]     │ ← Tabs
├──────────────────────────────────────────────────────────┤
│                                                          │
│                   No models downloaded yet                │
│                                                          │
│                     [Discover Models]                     │
│                                                          │
└──────────────────────────────────────────────────────────┘

Main tabs:

1. 🏠 Home

  • Overview of installed models
  • Quick actions
  • Recent chats

2. 🔍 Discover (Model Zoo)

  • Explore available models
  • Download with 1 click
  • Filters (size, quantization, task)

3. 💬 Chat

  • Conversational interface
  • Try out models
  • Adjust parameters

4. ⚙️ Settings

  • Model storage path
  • Hardware preferences (GPU, RAM)
  • API server config

✅ Step 6: Verification

Successful installation checklist:

  • LM Studio opens without errors
  • You see the 4 tabs (Home, Discover, Chat, Settings)
  • Settings → Model Storage shows a valid path
  • There are no error messages on screen

If all ✅: The installation is correct!

🔧 Recommended Settings

6.1 Hardware Acceleration:

Settings → Hardware

macOS (Apple Silicon):

GPU Acceleration: [✓] Enabled (Metal)
CPU Threads: Auto (default)

Windows/Linux (NVIDIA GPU):

GPU Acceleration: [✓] Enabled (CUDA)
GPU Layers: Auto (default)
CPU Threads: Auto

Without a GPU:

GPU Acceleration: [ ] Disabled
CPU Threads: Auto (uses all cores)

6.2 Model Storage:

Settings → Models

Model Storage Path: ~/lm-studio/models/
Storage Available: 45 GB  ✓

If you have little space (<10GB):

  • Switch to an external drive
  • Or free up space

🐛 Troubleshooting

Error: "Cannot open LM Studio" (macOS)

Cause: Gatekeeper is blocking the app

Solution:

xattr -cr /Applications/LM\ Studio.app

Then: Right-click → Open

Error: "Missing VCRUNTIME140.dll" (Windows)

Cause: The Visual C++ Redistributable is missing

Solution:

  1. Download: https://aka.ms/vs/17/release/vc_redist.x64.exe
  2. Install it
  3. Restart LM Studio

Error: "libGL error" (Linux)

Cause: Outdated GPU drivers

Solution (NVIDIA):

sudo ubuntu-drivers autoinstall
sudo reboot

Solution (AMD):

sudo apt install mesa-utils

App very slow to open

Cause: Indexing models (first time)

Solution: Wait 30-60 seconds (only the first time)

📊 Summary

What you did:

  1. Downloaded LM Studio:

    • Official installer (~200MB)
    • Compatible with your OS

  2. Installed it correctly:

    • macOS: App in Applications
    • Windows: Installer wizard
    • Linux: Executable AppImage

  3. Did the initial setup:

    • Model storage path
    • Hardware preferences
    • Analytics (optional)

  4. Verified it works:

    • App opens without errors
    • Interface visible (4 tabs)
    • Settings accessible

Checklist:

  • LM Studio installed
  • App opens correctly
  • Settings configured (storage, hardware)
  • No errors on screen

If all ✅: Ready to download models!

🔗 Additional resources

  1. LM Studio Installation Guide - Official docs
  2. Troubleshooting - Common issues
  3. Discord - Community support
  4. GitHub Issues - Report bugs

➡️ Next step

Next capsule: 03-downloading-models.md

Now that LM Studio is installed, you'll:

  • Explore the Model Zoo
  • Download your first model (Mistral 7B)
  • Understand quantization (Q4 vs Q8)
  • Manage models (delete, update)

Time: 20 minutes + download (10-30 min)
Difficulty: Low

Estimated time: 15 minutes
Next: 03-downloading-models.md

← PreviousModule 3: LM Studio - IntroductionNext →Downloading Models (Model Zoo)