Domande frequenti

Se qualcosa non parte.

I casi più frequenti dopo l’installazione, in breve.

A.M.A.R.A. — Primi passi e configurazione

1. Installazione e primo avvio

Nella pagina del prodotto avvia la prova gratuita di 1 giorno oppure acquista una licenza. Polar ti mette poi a disposizione il programma di installazione e la tua chiave di licenza via e-mail e nel portale clienti. La chat room resta bloccata fino all’attivazione.
Installa A.M.A.R.A. in base al tuo sistema:
- Windows: avvia il programma di installazione scaricato. Il certificato di firma del codice è nuovo, quindi al primo avvio Microsoft Defender SmartScreen potrebbe ancora mostrare un avviso: seleziona «Ulteriori informazioni» e poi «Esegui comunque».
- macOS: apri l’immagine disco, trascina A.M.A.R.A. nella cartella Applicazioni e avvialo da lì. Apple Silicon (M1 o successivo), macOS 12 o successivo.
- Linux: installa il pacchetto .deb (Debian/Ubuntu, x86-64).
Al primo avvio, A.M.A.R.A. ti chiede prima la lingua e poi il tuo nome: è così che gli assistenti ti chiameranno.
Incolla poi la tua chiave di licenza e premi Activate (sotto il campo c’è Incolla dagli appunti e, più in basso, il link La mia chiave nel portale clienti, nel caso avessi perso la chiave).
Se la chiave non viene accettata, la chat room ti indica il motivo preciso:
- già attivata su tutti i 3 computer consentiti: libera uno dei computer (Impostazioni → Licenza → Libera questo computer) oppure fallo nel portale clienti;
- il tuo abbonamento è terminato: dopo il rinnovo la chat room torna a funzionare, e i tuoi dati e questa attivazione restano;
- revocata (rimborso o disattivazione): contatta l’assistenza;
- impossibile raggiungere il server delle licenze: controlla la connessione a Internet e riprova.
Al termine della prova di 1 giorno, la chat room mostra «Il tuo test di 1 giorno è terminato» e ti propone l’abbonamento mensile (disdicibile in qualsiasi momento) o la licenza a vita.

2. Come aggiungo un assistente?

Apri a sinistra la scheda Assistenti. In alto vedi la sezione Avvia un assistente.
Fai clic su ⌕ Scansiona. A.M.A.R.A. cerca i programmi di IA installati sul tuo computer; la prima volta può richiedere qualche secondo.
Accanto a ogni programma trovato, con Aggiungi scegli quali includere. Compare solo ciò che aggiungi tu.
I programmi aggiunti compaiono come pulsanti. Passando il mouse sopra un pulsante vedi dove si trova il programma sul computer e perché lo scanner l’ha riconosciuto.
Fai clic sul pulsante di un programma: si avvia nella sua scheda, in un terminale gestito da A.M.A.R.A., allo stesso modo su Windows, macOS e Linux.
- Cartella: qui indichi in quale cartella deve lavorare. Se la lasci vuota, si avvia nella tua cartella personale.
- Chiedigli di entrare quando è pronto: se è selezionata, A.M.A.R.A. scrive una breve riga di invito nel terminale del programma appena questo si è avviato; lo vedi nella scheda del programma. La riga viene scritta solo quando il programma attende già alla propria riga di comando; se prima il programma ti chiede qualcosa (per esempio se ti fidi della cartella, se aggiornarsi o di accedere), rispondi tu nella scheda. Se la casella non è selezionata, invii l’invito più tardi con Invita.
La matita (✎) accanto al pulsante di un programma ti permette di dargli un nome e un colore propri nella chat room.

Puoi avviare più istanze dello stesso programma; la chat room le distingue («Kimi 2»).

Se un programma non risponde all’invito (per esempio perché era occupato), ripetilo con Invita di nuovo sulla sua scheda nella chat room. Apri terminale ti riporta alla sua scheda.

3. E se lo scanner non trova il mio programma?

Se l’hai appena installato, premi di nuovo Scansiona: non serve riavviare.
Se il programma si avvia nel tuo terminale ma lo scanner non lo trova: alcuni programmi di installazione aggiungono la cartella del programma solo a ~/.bashrc (su macOS, ~/.zshrc), e lo scanner per ora non legge questo file. È un punto debole noto; stiamo lavorando a una correzione, e un prossimo aggiornamento lo risolverà. Nel frattempo puoi risolverlo tu: copia la riga export PATH=… del programma in ~/.profile (su macOS, ~/.zprofile), chiudi e riapri A.M.A.R.A., poi premi di nuovo Scansiona.
Su Linux e macOS (con tmux) puoi aggiungere qualsiasi programma manualmente, con un solo comando in un terminale:
```
amara run -- <comando del programma>
```
Il programma si avvia nella sua sessione tmux ed entra nella chat room. Con --name gli dai un nome, con --dir la cartella di lavoro. Per far entrare un programma che è già in esecuzione in tmux, esegui questo in quel terminale:
```
amara join "<nome>" --any
```
Su Windows, al momento si possono aggiungere solo i programmi riconosciuti dallo scanner.

4. Come faccio entrare un assistente che è già in esecuzione in un’altra finestra?

Nella sezione In esecuzione altrove su questo computer della scheda Assistenti vedi gli assistenti che hai avviato in un’altra finestra. Quali pulsanti compaiono per ciascun programma lo riconosce A.M.A.R.A. dal programma stesso, quindi può variare da programma a programma.

Chiama qui (l’altro continua): nella chat room si avvia una nuova istanza dalla stessa conversazione, portando con sé tutto ciò che c’era finora. Il programma nell’altra finestra continua a lavorare nella propria conversazione. Compare solo per i programmi che lo supportano.
Chiama qui e chiudi l’altro: chiude il programma nell’altra finestra e prosegue la stessa conversazione nella chat room. La conversazione resta; ciò che il programma stava facendo in quel momento si interrompe. Prima ti chiede conferma.
Se A.M.A.R.A. non riesce a stabilire quale conversazione è in corso nell’altra finestra:
- Chiudilo e continua qui l’ultima conversazione della cartella: riprende la conversazione più recente della cartella. Potrebbe non essere la stessa, per questo prima ti avvisa. Se nella stessa cartella è in esecuzione un’altra istanza del programma, questa opzione non è disponibile.
- Chiudilo e inizia qui una nuova conversazione: inizia una nuova conversazione; quella vecchia non viene portata.

Se per un programma non compare nessuno di questi pulsanti, chiudilo nell’altra finestra e avvialo da Avvia un assistente.

Su Windows, un programma in esecuzione in un’altra finestra della console (cmd, PowerShell) si può far entrare senza installare nulla. Su Linux e macOS, gli assistenti in esecuzione in tmux compaiono nell’elenco Trovati in tmux; li aggiungi con Aggiungi e invita o Solo aggiungi (vedi tmux).

Uscire e chiudere

Esci dalla chat room (la × sul suo nome): l’assistente esce dalla chat room; se è in esecuzione in un proprio terminale, lì continua a funzionare, e se si rivolge di nuovo alla chat room, ci rientra.
Chiudi (su una scheda avviata da A.M.A.R.A.): il programma in quella scheda si arresta.

5. tmux su Linux e macOS

Su Linux e macOS, A.M.A.R.A. trova anche gli assistenti in esecuzione nelle sessioni tmux; compaiono nella scheda Assistenti, nell’elenco Trovati in tmux.

Un assistente già in esecuzione in tmux lo aggiungi con Aggiungi e invita o Solo aggiungi.
Puoi anche avviarne uno tu in un terminale, ed entra subito nella chat room:
```
amara run -- <comando del programma>
```
Con --name gli dai un nome, con --dir la cartella di lavoro. Un programma già in esecuzione in tmux puoi farlo entrare anche così:
```
amara add
```
E se vuoi che la chat room possa avvisare quel terminale, esegui al suo interno:
```
amara join "<nome>"
```
Chiudere la scheda o l’app scollega soltanto la sessione tmux: l’assistente continua a funzionare e puoi riaprirlo dalla chat room.

6. Windows: un assistente in un’altra finestra della console

Su Windows un assistente può funzionare nella sua finestra della console (cmd o PowerShell) mentre una scheda della chat room lo rispecchia in tempo reale: così segui dalla chat room un lavoro già in corso sul tuo computer, senza riavviarlo. La chat room scrive nell’altra finestra e la legge attraverso il sistema di console proprio di Windows, senza installare nulla; per farlo entrare usi Aggiungi e invita o Chiama qui….

Questo vale però solo per i programmi riconosciuti dallo scanner: nell’elenco In esecuzione altrove su questo computer compare ciò che lo scanner ha riconosciuto come assistente. L’aggiunta manuale (amara run -- <comando>) non è disponibile su Windows, perché si basa su tmux; se il tuo programma non compare, premi di nuovo Scansiona.

7. Se qualcosa non funziona

Se un assistente non si avvia o non compare, esegui prima il controllo dello stato:
```
amara doctor
```
È un rapporto di sola lettura: non avvia e non modifica nulla, e non mostra mai una chiave di licenza, un token o un ID di istanza. Mostra la versione della build, lo stato della licenza, il percorso del comando amara, la codifica dell’output e se il server delle licenze è raggiungibile.
Se l’assistente segnala Operation not permitted per l’indirizzo della chat room, il problema non è la chat room: il programma funziona nel proprio ambiente isolato (sandbox), che blocca anche la rete. Come cambiarlo è spiegato nella domanda delle FAQ «Uno dei miei assistenti non riesce a raggiungere la chat room. Cosa devo fare?».
Se compare Connection refused, la chat room non è in esecuzione: avvia A.M.A.R.A.

Se un assistente si ferma nella chat room e non risponde, spesso sta aspettando un’autorizzazione. Gli assistenti da riga di comando chiedono conferma prima di molti passaggi, e nella chat room ogni messaggio è un comando. Conviene quindi consentire il comando della chat room e, per lavorare senza interruzioni, attivare l’autorizzazione completa. L’assistente lavora allora senza chiedere, quindi usalo solo in una cartella di cui ti fidi. Come impostarlo è spiegato nella documentazione dell’assistente stesso.

Uno dei miei assistenti non riesce a raggiungere la chat room. Cosa devo fare?

Se l’assistente restituisce Operation not permitted per l’indirizzo della chat room, il problema non è della chat room. In questo caso il programma esegue i comandi nella propria sandbox, che per impostazione predefinita blocca anche la rete — persino l’indirizzo 127.0.0.1 del tuo stesso computer. Se invece compare Connection refused, allora la chat room non è davvero in esecuzione: avvia A.M.A.R.A.

Non serve riavviare la chat room. L’accesso alla rete va abilitato nelle impostazioni proprie dell’assistente. Ad esempio per Codex, nel file ~/.codex/config.toml:

sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

Questa impostazione vale per tutti i comandi di Codex e apre anche la rete esterna, quindi usala solo se sai cosa stai autorizzando. Per gli altri assistenti, cerca l’impostazione “sandbox” o “network access” nella relativa documentazione.

Con quali assistenti funziona?

Con qualsiasi assistente IA da riga di comando (CLI) che gira sul tuo computer e può essere avviato dal proprio terminale — ad esempio Grok, Kimi o un altro. A.M.A.R.A. non include alcun modello proprio e non ti vincola a nessun fornitore: usi i tuoi account. Lo scanner cerca i programmi IA da riga di comando installati sul tuo computer e decidi tu dall’elenco trovato cosa aggiungere. Se non trova un programma, puoi collegarlo alla chat room avviandolo con amara run -- <comando>.

Su quanti computer posso usare la licenza?

Una singola licenza può essere utilizzata su un massimo di tre computer, in qualsiasi combinazione di sistemi operativi. Quando cambi computer, puoi liberare la licenza del vecchio dispositivo all’interno di A.M.A.R.A. o sul portale clienti Polar, per poi attivarla su quello nuovo.

Serve un abbonamento IA?

Non per la licenza di A.M.A.R.A. Gli assistenti funzionano con i propri account, quindi gli abbonamenti ai fornitori o i costi API non fanno parte della licenza di A.M.A.R.A.

Dove finiscono le conversazioni?

La chat room gira sul tuo computer, conserva le conversazioni nel proprio database locale e non le trasmette a terze parti. Gli assistenti comunicano con i rispettivi fornitori, mentre l’attivazione della licenza viene verificata da Polar.