Ciele Desktop

Ciele Desktop è un'applicazione per macOS e Windows che si apre in base a una scelta.

• Sign in to your organization: l'app apre la console della tua organizzazione in una finestra dedicata, con una sessione che sopravvive ai riavvii. L'indirizzo è configurabile, quindi lo stesso percorso raggiunge anche una Ciele self-hosted sul tuo server.
• Use locally (self-host): una configurazione guidata installa un Ciele completo su questo computer: database, migrazioni, attività pianificate e tutto il resto. Non serve alcun terminale e Docker Desktop è l'unica cosa che devi installare tu.

Entrambi possono coesistere e puoi passare dall'uno all'altro in qualsiasi momento. Tutto ciò che fai effettivamente con Ciele avviene nell'interfaccia utente del prodotto che già conosci: l'app aggiunge una finestra intorno a essa, non una seconda interfaccia.

Quale percorso scegliere

Il percorso locale è un vero Ciele, non una demo: gli stessi container, le stesse migrazioni, gli stessi job pianificati che esegue il server self-host. Non è invece destinato a servire un widget di produzione al pubblico, che necessita di un indirizzo raggiungibile da tutti.

Installa

Entrambi i download sono disponibili nell'ultima versione.

macOS

1. Scarica il .zip per il tuo processore.
2. Decomprimilo e sposta Ciele.app nella cartella Applicazioni.
3. Right-click (or Control-click) Ciele.app and choose Open, quindi Open di nuovo nella finestra di dialogo.

Il terzo passaggio è importante. La versione beta non è firmata, quindi il doppio clic sul file eseguito nel modo consueto rimane bloccato da macOS finché non lo apri una volta in questo modo. Devi farlo solo una volta.

Windows

1. Scarica il programma di installazione di Setup.exe.
2. Eseguilo. SmartScreen dice "Windows ha protetto il tuo PC" perché la beta non è firmata. Seleziona More info, quindi Run anyway.

Se il download stesso è bloccato, fai clic con il pulsante destro del mouse sul file, apri Properties e seleziona Unblock.

Accedi alla tua organizzazione

Scegli Sign in nella schermata di benvenuto. L'app carica la console della tua organizzazione e memorizza la sessione, così che i successivi avvii ti portino direttamente lì.

Per indirizzare invece l'app a un server self-hosted, apri Settings e modifica l'indirizzo del server. Puoi accedervi dall'icona di controllo nella schermata di benvenuto oppure con ⌘, su macOS e Ctrl+, su Windows. Qualsiasi cosa http:// o https:// funziona. L'app mantiene l'origine e rilascia qualsiasi percorso tu incolli con essa.

L'app riproduce gli stessi brevi suoni di interfaccia della console. Interface sounds in Settings li disattiva per questo computer.

Sign out cancella la sessione memorizzata dall'app per quel server: cookie, cache e tutto il resto. Chiude più della semplice finestra. Su un computer condiviso, è la cosa giusta da fare.

Se l'indirizzo non si carica, l'app lo indica sulla propria schermata. Mostra l'indirizzo che ha provato, cosa è andato storto e i pulsanti per riprovare o correggerlo. Non ti ritroverai mai su una pagina di errore del browser in una finestra senza barra degli indirizzi.

Configurazione di un Ciele locale

Scegli Use locally. La procedura guidata esegue ogni passaggio e lo verifica prima di aprire quello successivo. Un segno di spunta verde indica che il passaggio ha funzionato, non che è stato completato.

1. Docker Desktop

La procedura guidata verifica che Docker Desktop sia installato e in esecuzione. Si tratta di problemi diversi con soluzioni diverse, e ti dice quale hai. Ogni errore ha la sua procedura dettagliata, scritta per chi non ha mai installato strumenti per sviluppatori. Il link di installazione rimanda alla pagina della tua piattaforma. Installa o avvia Docker Desktop, quindi premi Try again. Il controllo viene rieseguito sul posto.

2. Cartella dei dati e segreti

L'app crea una cartella per questa installazione e genera tutte le password e le chiavi necessarie allo stack. Non modificare mai un file di ambiente.

Se esiste già una configurazione, l'app la mantiene invece di generarne una nuova. Il tuo database è protetto con i segreti già presenti in quella cartella. Nuovi segreti ti impedirebbero di accedervi.

3. Scarica Ciele

Esegue il pull delle immagini del container pubblicate per questa versione dell'app. Questo è il passaggio più lento alla prima esecuzione. Non viene compilato nulla dal codice sorgente, per questo l'installazione richiede il tempo di una pausa caffè e non un intero pomeriggio.

4. Avvia lo stack

Avvia il database, l'app e i job pianificati in modo indipendente: continuano a funzionare anche dopo che hai chiuso Ciele Desktop.

5. Prepara il database

Applica lo schema e attende la risposta di Ciele. "I container sono stati avviati" e "Ciele sta servendo" sono affermazioni diverse, e questo passaggio attende la seconda.

6. Contenuti demo (facoltativo)

Carica un'organizzazione di esempio con assistenti, così vedrai un prodotto popolato prima di aggiungere qualsiasi elemento personale. Skip ti lascia con un Ciele vuoto ma funzionante.

7. Collega un modello di IA (facoltativo)

Indirizza Ciele a qualsiasi server compatibile con OpenAI o a un provider in hosting. Per Ollama su questa macchina, l'indirizzo è http://host.docker.internal:11434/v1: all'interno di un container, localhost è il container.

Puoi saltare questo passaggio. Senza un modello, gli assistenti rispondono utilizzando il motore di ricerca per parole chiave integrato e la ricerca nella Knowledge Base si basa sulla corrispondenza lessicale. Tutto il resto funziona.

Quando un passaggio fallisce, indica cosa è andato storto e conserva i relativi log in Show details. Try again riprende da quel passaggio invece di ricominciare da capo.

Una volta completata la configurazione, Open Ciele carica la console locale. Il primo account che crei è il proprietario dell'organizzazione. I lanci successivi saltano completamente la procedura guidata.

Secondo giorno

Stack status mostra se il tuo stack locale è attivo. Puoi accedervi dall'ultimo passaggio della procedura guidata, da Impostazioni o dal menu Ciele. Avvia e arresta lo stack senza Docker Desktop. "Running" in questo contesto significa che Ciele ha risposto, non che i container esistano.

L'arresto è reversibile e non influisce sui dati. Chiudere l'app non arresta lo stack. Viene eseguito in modo distaccato, di proposito.

Dove risiedono i tuoi dati

Esegui il backup del database come faresti con qualsiasi self-host; consulta Database. La disinstallazione dell'app non rimuove né i volumi né lo stack.

Aggiornamento in corso

All'avvio, l'app verifica la disponibilità di una versione più recente e mostra un avviso ignorabile con un link per il download. Non è previsto alcun aggiornamento automatico, perché nessuna delle due piattaforme aggiorna automaticamente un'app non firmata.

L'aggiornamento dell'app è ciò che fa avanzare il tuo stack locale. Ogni build fissa le immagini del container corrispondenti alla propria versione, quindi la successiva configurazione o il successivo avvio le estrae ed esegue nuovamente le migrazioni. I tuoi dati rimangono dove sono.

Ricominciare da capo

Per ripristinare l'installazione locale, interrompi lo stack dalla schermata di stato e rimuovi i volumi del progetto Compose con Docker Desktop oppure da un terminale:

docker compose --project-name ciele down -v

Questa operazione elimina il database locale e i file caricati. La prossima volta che scegli Use locally, la procedura guidata riparte dall'inizio.

Risoluzione dei problemi

"Docker Desktop non è installato" quando in realtà lo è. Un'app avviata dal Dock o dal menu Start non eredita il PATH della tua shell. Ciele cerca quindi la CLI di Docker nel percorso in cui Docker Desktop la installa. Su macOS si tratta delle directory Homebrew e /usr/local/bin. Su Windows si tratta della cartella Programmi e della cartella Programmi per utente. Non troverà un Docker che hai installato da nessun'altra parte. Su macOS, un collegamento simbolico a /usr/local/bin risolve il problema.

The stack sits on "Starting". Postgres potrebbe essere ancora in fase di inizializzazione alla prima esecuzione. Attendi un minuto, quindi premi Check again. Se rimane in quella posizione, apri i log da Docker Desktop. Un container che continua a riavviarsi di solito ha poca memoria.

"Non è stato possibile scaricare le immagini." Il pull non è riuscito a raggiungere il registro. Controlla la tua connessione o il proxy e premi Try again. Non è stato eseguito nulla a valle, quindi non c'è nulla da annullare.

Assistants answer, but they ignore my knowledge. Nessun modello di embedding è configurato, quindi il recupero ricade sulla corrispondenza delle parole chiave. Aggiungi un modello di embedding in Configurazione.

"Ciele non si è caricato" al momento dell'accesso. L'indirizzo nelle impostazioni non serve Ciele. La schermata indica cosa è andato storto. Un errore di battitura restituisce "that address does not exist". Un server spento restituisce il messaggio "nothing is listening". Un indirizzo che risponde senza essere Ciele lo dice. Change address ti porta direttamente all'impostazione.

macOS dice che l'app è danneggiata o non può essere aperta. Questo è Gatekeeper su un'app non firmata. Fai clic con il pulsante destro del mouse su Ciele.app, scegli Open, quindi Open di nuovo. Facendo doppio clic non verrà visualizzata questa opzione.

Windows blocks the installer. Si tratta di SmartScreen su un'app non firmata. Seleziona More info, quindi Run anyway. Se il file è stato bloccato al download, sbloccalo prima dalla sua Properties.

Cosa non è l'app desktop

• Non supporta i widget di produzione. I widget locali servono per il test e l'anteprima. Per la pubblicazione a visitatori reali è necessario un server raggiungibile.
• Non è firmata né autenticata e non si aggiorna automaticamente.
• Esegue solo i profili predefiniti. I worker opzionali pesanti rimangono disattivati. Aggiungili da Workers se ne hai bisogno.