Come iniziare

Primo avvio

Al primo avvio, Kucedr ti guida in cinque fasi visibili:

1. Benvenuto presenta Kucedr come agente personale per attività quotidiane, programmazione e lavoro in background.
2. Account consente di accedere, creare un account oppure continuare in modalità solo locale.
3. Modello richiede almeno una chiave API di un provider di modelli salvata. Una chiave soltanto digitata ma non salvata non completa la fase.
4. Ricerca collega facoltativamente un provider di ricerca supportato.
5. Modelli consente di scegliere provider e modello principali dell’Assistente. Voce realtime, trascrizione, sintesi vocale, immagini, audio, video e ricerca sono facoltativi.

Dopo aver salvato provider e modello dell'Assistente, agli avvii successivi Kucedr salta la configurazione e apre direttamente la chat. Puoi modificare tutte queste scelte in seguito nelle Impostazioni. Provider e modello per attività pianificate e health check si configurano separatamente nelle rispettive pagine.

La configurazione verifica che provider e modello siano salvati, ma non prova che le credenziali funzionino. Invia un breve messaggio nella Home. Se la richiesta fallisce, controlla la chiave salvata, il modello scelto, la connessione e l'errore restituito dal provider.

Dopo la configurazione

1. Inizia a chattare. Esamina le richieste di autorizzazione per file o comandi fuori dalle posizioni attendibili prima di consentirle.
2. Allega file dall'editor oppure detta il messaggio. L'editor non controlla numero, tipo, dimensione o compatibilità dei file con il modello prima dell'invio: un allegato non supportato può fallire durante l'elaborazione.
3. Se ti servono, configura speech-to-text, text-to-speech e la generazione di immagini, video e audio.
4. Estendi Kucedr con Plugin, App, Canali o Agenti remoti, secondo il lavoro da svolgere.
5. Crea uno strumento con un’interfaccia dedicata usando l’SDK di Kucedr quando un flusso di lavoro ha bisogno di una propria app.

Orientarsi nell'app

La barra laterale delle Impostazioni è divisa in Generali (inclusi Provider, Libreria e Workspace), Assistente, Brain ed Estensioni (Plugin, App, Canali e Agenti remoti). I collegamenti dell’Agente e la ricerca delle pagine espongono anche Skill, Attività, Cronologia chat, Knowledge, Health e Permessi. Coding è contrassegnato come Soon; il vecchio percorso apre Workspace.

• Cmd/Ctrl+F apre la ricerca di pagine e impostazioni.
• Cmd/Ctrl+/ porta il cursore nell'editor del prompt.
• Le pagine interne usano breadcrumb, i percorsi sconosciuti mostrano una schermata di recupero e le transizioni rispettano la preferenza di movimento ridotto.

La pagina Ricerca configura lo stesso motore Brave o Tavily e la stessa chiave usati dallo strumento di ricerca web dell'agente. Non è una funzione separata per cercare nei file locali.

Preferenze dell'applicazione

Puoi vedere nome e versione dell'app, mostrare o nascondere l'icona nella barra di sistema, impedire al computer di sospendersi lasciando comunque spegnere lo schermo, aprire la cartella dei dati dell'applicazione, scegliere inglese o italiano e usare il tema chiaro, scuro o di sistema. La modalità di sistema segue i cambiamenti del tema del sistema operativo.

Permessi per i media

Le pagine di sistema riguardano Microfono, Fotocamera e Acquisizione schermo. Su macOS, Kucedr mostra lo stato dei permessi, può richiedere l'accesso e apre il pannello corretto delle Impostazioni di Sistema. Puoi anche provare e riprodurre una registrazione del microfono, un'anteprima della fotocamera e una cattura dello schermo.

Sulle altre piattaforme, lo stato esplicito dei permessi di sistema può risultare sconosciuto e gli interruttori del microfono e della fotocamera nell'app non impediscono ancora l'acquisizione. La cattura dello schermo usa il selettore di sistema su macOS quando disponibile e un selettore nativo di Kucedr quando Electron restituisce più sorgenti; alcuni ambienti Linux con PipeWire espongono una sola sorgente gestita dal portale.

Piattaforme e lingue

Piattaforma	Pacchetti
Windows	Installer NSIS per x64, cartella di installazione selezionabile, collegamento sul desktop e dati dell'app conservati dopo la disinstallazione.
macOS	PKG e DMG per x64 e arm64, supporto alla modalità scura, runtime protetto e autorizzazioni per microfono e fotocamera.
Linux	AppImage e DEB.

L'interfaccia include cataloghi in inglese e italiano con un selettore della lingua, oltre ai temi chiaro, scuro e di sistema. La localizzazione è parziale: una parte importante dei testi della configurazione iniziale e della schermata Home, inclusi i suggerimenti per i prompt e il segnaposto dell'editor, è ancora solo in inglese.