Primo avvio

Al primo avvio, Kora presenta i metodi di connessione più usati nell’app desktop. Completa la connessione, scegli un modello disponibile e crea il primo progetto senza uscire dall’onboarding.

Collegare un modello

Seleziona uno dei metodi di connessione principali:

Metodo	Quando usarlo	Cosa devi fornire
ChatGPT Plus/Pro	Vuoi usare un account OpenAI ChatGPT	Accesso OpenAI nel browser o codice dispositivo
Models.dev	Possiedi una chiave API per un provider presente nel catalogo models.dev	Chiave API del provider
Kora Cloud Flash	Hai attivato Flash in Kora Cloud	Chiave Kora Cloud

Kora, OpenAI e le voci selezionate da Models.dev sono provider o metodi di connessione. Il passaggio successivo elenca i modelli realmente disponibili attraverso la connessione selezionata.

ChatGPT Plus/Pro

1. Seleziona ChatGPT Plus/Pro.
2. Seleziona Sign in with OpenAI e completa l’autorizzazione nel browser.
3. Se il browser non riesce a tornare a Kora, usa Or sign in with a device code e inserisci il codice mostrato nell’URL di verifica.
4. Dopo la connessione dell’account, seleziona Refresh Models.
5. Seleziona un modello in Initial model.
6. Seleziona Continue.

L’elenco disponibile dipende dall’account collegato e dai modelli supportati da Kora.

Models.dev

1. Seleziona Models.dev.
2. Cerca nel catalogo models.dev e seleziona un provider.
3. Controlla il base URL precompilato e inserisci la chiave API del provider.
4. Seleziona Test Connection.
5. Abilita i modelli che vuoi rendere disponibili in Kora, poi seleziona Add Provider.
6. Seleziona il provider in Already configured providers.
7. Seleziona un Initial model, poi seleziona Continue.

Usa Add custom provider manually nello stesso flusso quando un provider OpenAI-compatibile non è presente nel catalogo.

Kora Cloud Flash

1. Seleziona Kora Cloud Flash.
2. Incolla la chiave Kora Cloud.
3. Attendi la convalida della chiave.
4. Seleziona un Initial model, poi seleziona Continue.

Consulta Collegare Kora Cloud se devi ancora attivare Flash o creare una chiave.

Creare il primo progetto

1. Inserisci un Project Name.
2. In Working Directory, inserisci un percorso locale oppure seleziona Browse.
3. Controlla connessione, provider e modello mostrati nel riepilogo.
4. Seleziona Continue.

Kora può leggere e modificare i file contenuti nella directory di lavoro selezionata. Il progetto viene creato con il provider e il modello mostrati nel riepilogo.

Completare e inviare un messaggio

Attiva Start the tour right away per vedere i controlli principali, poi seleziona Start tour. Lascialo disattivato e seleziona Create project per entrare subito nel workspace.

Nella nuova sessione:

1. Controlla il selettore provider/modello nel compositore della chat.
2. Scrivi una richiesta.
3. Premi Invio per inviarla. Usa Shift + Invio per una nuova riga.

Puoi cambiare provider e modello dal compositore prima di un messaggio successivo.

Ripetere l’onboarding o la visita guidata

Apri Impostazioni → Appearance. In Getting Started:

• Repeat onboarding riapre il flusso del primo avvio.
• Restart tour avvia la visita guidata dell’interfaccia.

Ripetere l’onboarding non elimina progetti, sessioni o configurazioni dei provider esistenti.

Risoluzione problemi

• L’accesso OpenAI non torna a Kora → usa l’opzione con codice dispositivo nel passaggio ChatGPT.
• Models.dev non carica il catalogo → controlla la rete e riprova; usa un risultato in cache solo dopo aver verificato che endpoint e modelli siano ancora aggiornati.
• Non è possibile selezionare un modello → aggiorna il provider collegato e abilita almeno uno dei modelli restituiti.
• La cartella selezionata appare vuota → verifica che l’utente macOS possa leggere il percorso e che sia attiva la cartella corretta del progetto.