XTERM Terminal Setup Guide
Ogni studente riceve un server privato, un laboratorio Node-RED e Google Gemini CLI preinstallato. Proteggi la tua chiave API, incollala nel terminale, invia un messaggio di chat veloce e conferma che il tuo assistente AI è connesso. Completa i passaggi in questa pagina, quindi utilizza il pulsante di completamento nella parte superiore di questa attività per sbloccare la missione successiva.
- Server AI personale (con WebTerminal con modalità Chat e Voce) + archiviazione persistente
- Gemini + Claude CLI preinstallato (AI Modalità Cloud Bot)
- Stack di automazione Node-RED personale
- Conferma l'accesso al terminale dal drawer dei messaggi (
admincredenziali) - Crea una chiave Gemini API su aistudio.google.com e incollalo nel terminale
- Ordina Gemini per creare il flusso Node-RED iniziale
Hai bisogno di nuovo delle credenziali WebTerminal (VNC + XTerm) o Node-RED? Fai clic sull'icona del fumetto in alto a destra. Attiva/disattiva il cassetto dei messaggi — il messaggio dell'amministratore include tutti gli URL e le password. Rispondi lì in qualsiasi momento se hai bisogno di aiuto.

Apri i messaggi, accedi come amministratore, conferma che la chat Gemini è pronta
Crea la chiave in AI Studio, incollala nel terminale, quindi premi Invio (pulsante Invio sulla tastiera o sul terminale).
Invia un saluto veloce (ad esempio, test) e conferma le risposte di Gemini
Utilizza il prompt preparato dal passaggio 4: copialo, incollalo nella chat Gemini, quindi premi Invio (pulsante Invio sulla tastiera o sul terminale).
Una volta completato tutto ciò che segue, utilizza il pulsante di completamento nella parte superiore di questa attività in modo che il sistema sblocchi il livello del corso e il compito successivi.
Interfaccia chat-first: scrivi in inglese semplice e Gemini gestisce l'esecuzione sul tuo server.
Gemini ti dirà quando il flusso sarà pronto. Successivamente, fai clic su Reload e verifica l'aggiornamento del canvas.
Passaggio 1 · Confermare prima l'accesso al terminale
Inizia dal cassetto dei messaggi. Prima di creare qualsiasi chiave API, assicurati che il terminale sia disponibile e di poter accedere correttamente.
- Apri il cassetto dei messaggi (fumetto) e attendi due messaggi dell'amministratore: Node-RED credenziali, quindi WebTerminal is ready.
- Dopo WebTerminal is ready, copia le credenziali del terminale (
admin+ password) dai messaggi. - Aggiorna la pagina (F5), accedi al terminale e salva le credenziali nel browser per le sessioni successive.
- Se il frame del terminale non viene caricato, fare clic su ↗ Open in new tab e continuare da lì.
- Quando viene visualizzata la chat Gemini e viene richiesta l'attivazione della chiave API, passare al passaggio 2.
Passaggio 2 · Genera la chiave API e attiva Gemini
Ora genera la chiave in Google AI Studio e incollala nella chat del terminale in modo che Gemini possa iniziare a funzionare sul tuo server.
- Aprire Google AI Studio → API Tasti.
- Accetta i termini di Google/licenses se richiesto.
- Seleziona un progetto esistente o creane uno nuovo.
- Fai clic su Crea API chiave, quindi copia la chiave generata.
- Torna al terminale e incolla la chiave utilizzando il menu di scelta rapida o
Ctrl+Shift+V. - Premere Invio e attendere la conferma (ad esempio,
Gemini API chiave salvata).
Passaggio 3 · Verifica la chat e gestisci i limiti di quota
Gemini viene eseguito in modalità chat. Parlagli nello stesso modo in cui parli ai mentori: non è richiesta la sintassi dei comandi.
Se vedi
API Errore: hai esaurito la tua quota giornaliera su questo modello. 
quindi apri le impostazioni del terminale con /settings e assicurati che Funzioni anteprima = ON.


Successivamente, apri il selettore del modello con /model.

Scegli la modalità Manual e seleziona gemini-3-flash-preview. Abilita "Ricorda modello per sessioni future".

Riprova il tuo messaggio. Se il limite appare nuovamente, attendere circa 5 minuti. Se il problema persiste, probabilmente hai raggiunto il limite giornaliero (RPD) e potrebbe essere necessario attendere fino a 24 ore.

Puoi anche passare a una chiave Google Cloud project/API diversa o chiedere aiuto qui: https://t.me/sell_systems
Se necessario, imposta la fatturazione per sbloccare limiti tariffari più elevati.

Se hai ancora bisogno di aiuto, contatta un amministratore qui: https://t.me/sell_systems
Percorso di ripristino alternativo: utilizza un nuovo progetto o una nuova chiave API.
| Problema | Aggiustare |
|---|---|
| "Chiave API non valida" | Elimina la chiave in AI Studio → creane una nuova → incolla di nuovo. |
| Il terminale non risponde | Premi Reload, attendi 10 secondi, ripeti il messaggio. |
| Singhiozzo di rete | Ripristina Wi-Fi/VPN, aggiorna la pagina, riprova. |
Passaggio 4 · Avviare il flusso iniziale
Ora utilizza il prompt della missione preparato di seguito: copialo, incollalo nella chat Gemini, premi Invio (pulsante Invio sulla tastiera o sul terminale) e supervisiona l'esecuzione. Questa è la tua prima automazione per piccole vincite.
Incollalo nel terminale, quindi premi Invio (o dillo con parole tue):
Hai bisogno di ispezionare la guida manualmente? Apri il README iniziale in una nuova scheda e seguire gli stessi passaggi.
✦ Gemini segnala i progressi mentre funziona. Rispondi alle sue domande, conferma le richieste e quando dice che il flusso è pronto, fai clic su Reload per esaminare le modifiche in Node-RED. Se qualcosa non è chiaro, invia un messaggio di follow-up o contatta un amministratore: mantieni il pieno controllo.
L'output previsto dovrebbe essere simile al seguente: 
Gemini di solito risponde in questo modo quando tutto è completo:
Quando i modelli GitHub si espanderanno, aggiungeremo qui richieste più avanzate.
Gemini può chiedere il permesso di eseguire comandi (ad esempio, ls ). Approva queste richieste in modo che Gemini possa ispezionare l'ambiente. Rimani l'operatore e confermi ogni azione.
Utilizza il riquadro dei messaggi (fumetto in alto a destra) per rivedere le istruzioni dell'amministratore o chiedere aiuto. Tutto (credenziali WebTerminal, URL Node-RED, suggerimenti extra) risiede lì. Oppure chiedi qui https://t.me/sell_systems
Pronti per la parte successiva? Utilizza il pulsante di completamento nella parte superiore di questa attività.
