Módulo 3: LM Studio - Introducción

Instalación de LM Studio

Descripción de la cápsula

Primer paso práctico: instalar LM Studio en tu máquina (Mac, Windows, o Linux).

El proceso es simple (5-10 minutos):

  1. Descargar instalador
  2. Instalar aplicación
  3. Primera ejecución
  4. Verificar que funciona

Tiempo: 15 minutos
Dificultad: Muy baja


🎯 Objetivos

  • ✅ Descargar LM Studio para tu OS
  • ✅ Instalar correctamente
  • ✅ Abrir aplicación (primera vez)
  • ✅ Tour básico de la interfaz

💻 Paso 1: Verificar Requisitos

Sistema operativo compatible:

OSVersión MínimaRecomendada
macOS11 Big Sur13 Ventura+
Windows10 (64-bit)11
LinuxUbuntu 20.04+Ubuntu 22.04+

Espacio en disco:

# macOS/Linux
df -h ~

# Windows
wmic logicaldisk get size,freespace,caption

Necesitas: Mínimo 10GB libre (20GB+ recomendado)


📥 Paso 2: Descargar LM Studio

2.1 Visita sitio oficial:

https://lmstudio.ai/


2.2 Descarga para tu OS:

macOS:

  • Clic en "Download for Mac"
  • Archivo: LM-Studio-<version>.dmg (~200MB)
  • Apple Silicon (M1/M2/M3): Versión ARM nativa
  • Intel: Versión x86_64

Windows:

  • Clic en "Download for Windows"
  • Archivo: LM-Studio-<version>.exe (~180MB)

Linux:

  • Clic en "Download for Linux"
  • Archivo: LM-Studio-<version>.AppImage (~190MB)

Tiempo de descarga: 2-10 minutos (según internet)


📦 Paso 3: Instalación

macOS:

  1. Abre el archivo .dmg descargado
  2. Arrastra LM Studio.app a la carpeta Applications
  3. Primera vez: Click derecho → "Open" (bypass Gatekeeper)
  4. Confirma "Open" en el diálogo de seguridad

Si ves error "App is damaged":

xattr -cr /Applications/LM\ Studio.app

Windows:

  1. Ejecuta el instalador .exe
  2. Click "Next" en wizard
  3. Elige directorio de instalación (default OK)
  4. Click "Install"
  5. Espera 1-2 minutos
  6. Click "Finish"

Shortcut: Desktop + Start Menu automáticamente


Linux (AppImage):

# 1. Mover a directorio apropiado
mv ~/Downloads/LM-Studio-*.AppImage ~/Applications/

# 2. Dar permisos de ejecución
chmod +x ~/Applications/LM-Studio-*.AppImage

# 3. Ejecutar
~/Applications/LM-Studio-*.AppImage

Opcional: 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

🚀 Paso 4: Primera Ejecución

4.1 Abrir LM Studio:

macOS: Applications → LM Studio
Windows: Start Menu → LM Studio
Linux: Ejecutar AppImage


4.2 Pantalla de bienvenida:

Primera vez verás:

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

Click "Get Started"


4.3 Configuración inicial:

Analytics: (Opcional)

  • LM Studio pregunta si enviar analytics anónimos
  • Elige "Allow" o "Don't Allow" (no afecta funcionalidad)

Model Storage: (Importante)

  • LM Studio pregunta dónde guardar modelos
  • Default: ~/lm-studio/models/ (OK para mayoría)
  • Si tienes disco externo: Puedes cambiar aquí

Recomendación: Usa default (puedes cambiar después en Settings)


🖥️ Paso 5: Tour de la Interfaz

Pantalla principal (UI Overview):

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

Tabs principales:

1. 🏠 Home

  • Overview de modelos instalados
  • Quick actions
  • Recent chats

2. 🔍 Discover (Model Zoo)

  • Explora modelos disponibles
  • Descarga con 1 clic
  • Filtros (size, quantization, task)

3. 💬 Chat

  • Interfaz conversacional
  • Prueba modelos
  • Ajusta parameters

4. ⚙️ Settings

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

✅ Paso 6: Verificación

Checklist de instalación exitosa:

  • LM Studio abre sin errores
  • Ves las 4 tabs (Home, Discover, Chat, Settings)
  • Settings → Model Storage muestra path válido
  • No hay mensajes de error en pantalla

Si todos ✅: Instalación correcta!


🔧 Settings Recomendadas

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

Sin GPU:

GPU Acceleration: [ ] Disabled
CPU Threads: Auto (usa todos los cores)

6.2 Model Storage:

Settings → Models

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

Si poco espacio (<10GB):

  • Cambia a disco externo
  • O libera espacio

🐛 Troubleshooting

Error: "Cannot open LM Studio" (macOS)

Causa: Gatekeeper bloqueando app

Solución:

xattr -cr /Applications/LM\ Studio.app

Luego: Click derecho → Open


Error: "Missing VCRUNTIME140.dll" (Windows)

Causa: Falta Visual C++ Redistributable

Solución:

  1. Descarga: https://aka.ms/vs/17/release/vc_redist.x64.exe
  2. Instala
  3. Reinicia LM Studio

Error: "libGL error" (Linux)

Causa: Drivers GPU desactualizados

Solución (NVIDIA):

sudo ubuntu-drivers autoinstall
sudo reboot

Solución (AMD):

sudo apt install mesa-utils

App muy lenta al abrir

Causa: Indexando modelos (primera vez)

Solución: Espera 30-60 segundos (solo primera vez)


📊 Resumen

Lo que hiciste:

  1. Descargaste LM Studio:

    • Instalador oficial (~200MB)
    • Compatible con tu OS
  2. Instalaste correctamente:

    • macOS: App en Applications
    • Windows: Installer wizard
    • Linux: AppImage ejecutable
  3. Configuraste inicial:

    • Model storage path
    • Hardware preferences
    • Analytics (opcional)
  4. Verificaste funcionamiento:

    • App abre sin errores
    • Interfaz visible (4 tabs)
    • Settings accesibles

Checklist:

  • LM Studio instalado
  • App abre correctamente
  • Settings configurados (storage, hardware)
  • Sin errores en pantalla

Si todos ✅: Listo para descargar modelos!


🔗 Recursos adicionales

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

➡️ Próximo paso

Siguiente cápsula: 03-descarga-modelos.md

Ahora que LM Studio está instalado, vas a:

  • Explorar el Model Zoo
  • Descargar tu primer modelo (Mistral 7B)
  • Entender quantization (Q4 vs Q8)
  • Gestionar modelos (eliminar, update)

Tiempo: 20 minutos + descarga (10-30 min)
Dificultad: Baja


Tiempo estimado: 15 minutos
Siguiente: 03-descarga-modelos.md