LM Studio

Introduzione

LM Studio è un gestore locale di modelli IA che consente di eseguire modelli linguistici di grandi dimensioni open source, come Mistral, Llama e Phi, direttamente sul tuo computer.

Invece di utilizzare API cloud, LM Studio esegue i modelli in locale ed espone un endpoint API locale a cui altre applicazioni possono connettersi.

Questa configurazione è utile se:

• Hai bisogno del pieno controllo sui tuoi dati
• Lavori in un ambiente offline
• Devi rispettare le policy di sicurezza interne
• Vuoi evitare i costi delle API esterne

Prima di iniziare, assicurati che LM Studio sia installato e in esecuzione e che il plugin IA sia installato e abilitato in ONLYOFFICE.

Requisiti di sistema

Componente	Requisito
Sistema operativo	Windows (x64, ARM64), macOS (Apple Silicon), Linux (x64)
CPU	Richiesto il supporto del set di istruzioni AVX2 (sistemi x64)
RAM	16 GB consigliati
GPU	4 GB di VRAM consigliati; l'esecuzione solo su CPU è possibile ma significativamente più lenta

Configurazione rapida

Passo 1. Installa LM Studio

1. Scarica LM Studio dal sito web ufficiale di LM Studio (disponibile per Windows, macOS e Linux).
2. Installa e avvia l'applicazione.
3. Seleziona una cartella locale in cui verranno archiviati i modelli IA.

A questo punto LM Studio è installato ma non ancora collegato a ONLYOFFICE.

Passo 2. Abilita e prepara il server API locale

ONLYOFFICE richiede due cose a LM Studio: un modello caricato e un server API in esecuzione.

1. Scarica un modello

   1. Apri la sezione Modelli.
   2. Scegli un modello adatto al tuo hardware.
   3. Scarica il modello e assicurati che sia completamente caricato.

2. Avvia il server API

   1. Vai alla scheda Server.
   2. Cambia lo stato del server da Arrestato a In esecuzione oppure premi Cmd+R su macOS.
   3. Annota l'URL di base, ad esempio: http://127.0.0.1:1234.

Una volta scaricato il modello e avviato il server, il tuo sistema funziona come un endpoint IA privato.

Passo 3. Abilita il plugin IA

1. Apri ONLYOFFICE Desktop Editors versione 9.0.4 o successiva.
2. Vai a Plugin → Gestore Plugin.
3. Installa o aggiorna il plugin IA, quindi chiudi il Gestore Plugin.
4. Vai a Plugin → Plugin in Background e abilita il plugin IA.

Passo 4. Collega LM Studio a ONLYOFFICE

1. Apri la scheda IA → Impostazioni → Modifica modelli AI e fai clic sull'icona + per aggiungere un nuovo modello.

2. Inserisci quanto segue:

   • Nome del modello: LM Studio
   • URL: l'URL di base visualizzato nella scheda Server di LM Studio, ad esempio http://127.0.0.1:1234/v1
   note

   Quando ti colleghi tramite un browser web, Abilita CORS deve essere attivato nelle Impostazioni del server. Senza di esso, il browser bloccherà le richieste all'API di LM Studio.

3. L'elenco dei modelli viene aggiornato automaticamente. Se desideri farlo manualmente, fai clic su Aggiorna modelli.

4. Assegna le attività che vuoi che questo modello gestisca, quindi salva.

Se la connessione ha esito positivo, ONLYOFFICE instraderà le richieste al tuo modello locale.

Utilizzo dell'assistente IA

Scorciatoie da tastiera:

Azione	Piattaforma	Scorciatoia
Apri l'assistente IA	Windows / Linux	Ctrl+/
Apri l'assistente IA	macOS	⌘+/
Cancella la cronologia della conversazione	Windows / Linux	Ctrl+Alt+/
Cancella la cronologia della conversazione	macOS	⌘+⌥+/
Chiudi il pannello dell'agente IA	Tutte le piattaforme	Esc

Risoluzione dei problemi

Impossibile connettersi a LM Studio

Verifica che il server sia in esecuzione nella scheda Server e che l'URL in ONLYOFFICE corrisponda esattamente a quello mostrato da LM Studio, compreso il numero di porta. Se la connessione continua a non riuscire, controlla se un firewall o un antivirus sta bloccando il traffico localhost. Riavvia entrambe le applicazioni dopo aver apportato eventuali modifiche.

Le risposte sono lente

Le risposte lente sono quasi sempre un limite dell'hardware, non un problema di configurazione. I modelli più grandi consumano più RAM e traggono vantaggio dall'accelerazione GPU. Passare a un modello quantizzato più piccolo e chiudere le altre applicazioni che consumano molta memoria in genere migliora i tempi di risposta.

Il pannello dell'assistente IA si apre ma non risponde

Se il pannello si apre ma non viene generata alcuna risposta, la causa più comune è che nessun modello è caricato. Il server API può essere in esecuzione senza un modello, ma in questo stato non può elaborare le richieste. Verifica che un modello sia scaricato e attivamente caricato in LM Studio. Assicurati inoltre che il modello sia assegnato all'attività Chat nelle impostazioni IA di ONLYOFFICE.

L'elenco dei modelli non si aggiorna

Il server API deve essere in esecuzione prima dell'apertura di ONLYOFFICE. Se hai avviato LM Studio dopo aver aperto l'editor, riavvia ONLYOFFICE e aggiorna l'elenco dei modelli.