Questa guida spiega dove aprire Metnos, come effettuare il primo accesso, come usare la chat e come aggiungere un utente. La struttura delle pagine di amministrazione è descritta separatamente nella guida all'interfaccia.
Metnos viene eseguito su un computer locale, a casa o in ufficio. Non si accede attraverso un sito pubblico: l'indirizzo dipende dalla macchina su cui è installato. Le indicazioni che seguono riguardano quella macchina e la rete locale a cui è collegata.
La chat web è disponibile sulla porta 8770. Per aprirla, scrivi l'indirizzo completo nella barra degli indirizzi del browser, compresi http:// e :8770. Sul computer che ospita Metnos puoi usare http://127.0.0.1:8770/. Se, per esempio, l'indirizzo di quel computer nella rete locale è 192.168.1.42, da un telefono o da un portatile collegato alla stessa rete devi scrivere http://192.168.1.42:8770/.
Di norma, l'installazione guidata rende la chat raggiungibile dalla rete locale. Durante l'installazione di Metnos, al passaggio 4, è possibile scegliere per maggiore sicurezza di consentire l'accesso soltanto dal computer che ospita il sistema. In questo caso la chat può essere aperta solo con un browser eseguito su quel computer; gli altri dispositivi della rete locale non possono collegarsi.
| Dispositivo da cui ti colleghi | Indirizzo da scrivere nel browser |
|---|---|
| Dal computer che ospita Metnos | http://127.0.0.1:8770/ |
| Da un altro dispositivo della stessa rete locale | http://192.168.1.42:8770/ (esempio: usa l'indirizzo mostrato dall'installazione) |
Non occorre ricostruire l'indirizzo: al termine dell'installazione Metnos mostra gli indirizzi disponibili e li registra in ~/.local/share/metnos/install_summary.md. Per recuperarli in seguito, è sufficiente consultare quel file.
Al termine dell'installazione Metnos fornisce un indirizzo completo, già provvisto di un codice di accesso monouso. Aprilo senza modificarlo. Se vengono mostrati più indirizzi, uno è destinato al computer che ospita Metnos e gli altri ai dispositivi collegati alla stessa rete.
Se il codice è scaduto, puoi generarne uno nuovo ripetendo l'ultima fase dell'installazione. In alternativa, apri /admin/login e inserisci la chiave di amministrazione. La chiave è conservata sul computer che ospita Metnos, nel file ~/.config/metnos/admin.key: deve essere letta soltanto da quella macchina e non deve essere comunicata ad altri.
./.venv/bin/python -m install --force-phase 6Dopo il primo accesso, il browser conserva la sessione e non richiede la chiave a ogni visita.
La pagina principale ospita una conversazione: puoi formulare in italiano ciò che desideri ottenere, senza imparare un elenco di comandi. Quando una richiesta richiede una conferma in base ai permessi, al livello di autonomia e alle policy applicabili, Metnos presenta l'operazione prevista e attende il consenso prima di procedere.
È possibile usare Metnos anche da Telegram. Il sistema, l'identità e i permessi restano gli stessi, mentre ciascun canale conserva una conversazione e una cronologia proprie. Le pagine di amministrazione sono disponibili soltanto nell'interfaccia web: un percorso di Settings indicato su Telegram deve quindi essere aperto nel browser.
La Reference dei domini descrive gli ambiti in cui l'installazione può operare e propone esempi di richieste formulate in linguaggio naturale.
Dalla chat web si accede a Settings, l'area amministrativa. La pagina iniziale offre una panoramica dello stato del sistema e conduce a quattro sezioni; gli indirizzi delle pagine amministrative cominciano con /admin. La mappa completa dell'interfaccia è generata dal registro del sistema e rimane quindi allineata ai componenti effettivamente installati.
Le pagine sotto /admin sono riservate all'amministratore dell'istanza. Un ospite invitato può usare la chat, ma non accedere alle impostazioni.
/admin/users, senza una sessione amministrativa valida, Metnos ti porta alla pagina di accesso e conserva la destinazione. Dopo aver inserito la chiave di amministrazione, il browser torna automaticamente alla pagina richiesta. Per esempio, se Metnos risponde all'indirizzo 192.168.1.42, puoi aprire http://192.168.1.42:8770/admin/users: quando necessario, il passaggio da /admin/login avviene nello stesso browser. Un utente autenticato ma privo del ruolo amministrativo riceve invece un rifiuto esplicito e non acquisisce nuovi permessi.Questa procedura consente a un altro utente, per esempio un familiare o un ospite, di usare l'istanza con un'identità, una cronologia e permessi propri. L'operazione comprende due passaggi distinti: la creazione del profilo e l'associazione di un canale di accesso.
/admin/users.| Campo | Valore |
|---|---|
| nome | Un identificativo breve composto soltanto da lettere minuscole, cifre e trattino basso, per esempio lucia o marco_r. Il campo è obbligatorio. |
| nome visualizzato | Il nome mostrato nell'interfaccia, per esempio Lucia Rossi. |
| L'indirizzo dell'utente, se disponibile. | |
| ruolo | guest per un ospite; host per un secondo proprietario. Se non occorre attribuire il ruolo di proprietario, scegli guest. |
| autonomia | Il livello entro cui l'utente può operare: read_only consente soltanto la consultazione, restricted richiede conferma per le operazioni che modificano lo stato, full consente di procedere senza conferma. Se non hai esigenze diverse, scegli restricted. |
Seleziona il nome dell'utente per aprirne la pagina di dettaglio, quindi genera un codice di collegamento per il canale prescelto. Il codice è monouso e rimane valido per un'ora.
/start seguito dal codice; il bot conferma l'avvenuto collegamento.Dalla stessa pagina puoi successivamente modificare i dati dell'utente, scollegare un canale, aggiornare le preferenze o eliminare l'utente.
Non è necessario ricordare tutti i percorsi. Puoi chiedere indicazioni direttamente nella chat, con espressioni naturali come «dove si cambia il modello?» oppure «come posso invitare un utente?». Il Tutor indica il percorso e l'indirizzo appropriati e descrive ciò che è effettivamente disponibile nella tua installazione. Se una pagina non esiste, lo dichiara senza suggerire un percorso inesistente.