Gnotes è un’applicazione dedicata alla gestione degli appunti in Markdown, progettata per essere ospitata su un server personale e accessibile da computer e dispositivi mobili. Il progetto punta a combinare la semplicità delle note in testo semplice con funzionalità moderne come la modifica collaborativa, la ricerca semantica e l’integrazione con servizi di intelligenza artificiale.
La possibilità di mantenere il servizio sotto il proprio controllo rende Gnotes interessante per chi utilizza un server domestico, un VPS oppure un’infrastruttura privata. Gli utenti possono scrivere, organizzare e condividere le proprie note senza rinunciare alla disponibilità di una copia Markdown leggibile anche al di fuori dell’applicazione.
Uno degli elementi distintivi è la collaborazione in tempo reale. È possibile condividere una singola nota oppure un intero quaderno con altre persone che utilizzano il server. Le modifiche vengono sincronizzate automaticamente, consentendo a più utenti di lavorare contemporaneamente sullo stesso contenuto. Il sistema gestisce anche le modifiche effettuate offline, cercando di unirle automaticamente quando la connessione torna disponibile.
Ricerca intelligente, collegamenti tra note e strumenti AI
Gnotes offre diverse funzioni per organizzare le informazioni e collegare tra loro gli appunti. Il sistema riconosce collegamenti interni scritti con la sintassi [[Titolo]], permettendo di creare una rete di riferimenti tra le note. Sono supportati anche i normali indirizzi web e i collegamenti Markdown nel formato [testo](url), così da raccogliere nella stessa applicazione informazioni personali, documentazione e risorse online.
Un’altra funzione interessante è Ask your notes, una chat capace di cercare contenuti negli appunti utilizzando parole chiave oppure il significato delle richieste. Le risposte possono includere riferimenti alle note utilizzate come fonte, facilitando la verifica delle informazioni recuperate. Questo approccio può essere utile quando si accumulano documenti, promemoria e appunti tecnici e diventa difficile ritrovare rapidamente un dettaglio.
L’intelligenza artificiale può intervenire anche direttamente nel testo. Gnotes permette di riassumere una nota, migliorarne la struttura o riscriverla seguendo le istruzioni dell’utente. Sono inoltre disponibili funzioni per registrare promemoria vocali con trascrizione in tempo reale e per estrarre il testo dalle fotografie allegate.
Queste capacità non sono obbligatorie. L’amministratore può attivarle dalla sezione Settings, nella voce AI Services, configurando un endpoint compatibile con le API OpenAI. È possibile utilizzare un servizio ospitato online oppure una soluzione locale, in base alle proprie esigenze e all’infrastruttura disponibile. La scelta di un endpoint locale può essere particolarmente interessante per chi desidera limitare la dipendenza da servizi esterni, verificando comunque le caratteristiche di sicurezza e riservatezza della configurazione adottata.
Installazione di Gnotes con Docker e accesso offline
L’installazione proposta dal progetto utilizza Docker, una soluzione pratica per distribuire l’applicazione su un server Linux senza dover configurare manualmente ogni componente. Per accedere al servizio da Internet è necessario predisporre un dominio con HTTPS oppure utilizzare Tailscale per raggiungere il server attraverso una rete privata.
Il comando Docker indicato dal progetto avvia il container, configura il riavvio automatico e crea un volume persistente per conservare i dati:
docker run -d --name gnotes --restart unless-stopped \
-p 127.0.0.1:8080:8080 \
-v gnotes-data:/data \
-e GNOTES_PUBLIC_URL=https://notes.example.com \
ghcr.io/justinmdickey/gnotes:latestNel comando, gnotes-data è il volume utilizzato per mantenere i dati anche quando il container viene riavviato o ricreato. La porta 8080 viene associata all’indirizzo locale 127.0.0.1, quindi il servizio non risulta direttamente esposto sulla rete: per renderlo accessibile tramite il dominio configurato è necessario predisporre un reverse proxy con HTTPS oppure un’altra soluzione di accesso coerente con la propria rete.
Il valore https://notes.example.com è un esempio e deve essere sostituito con l’indirizzo pubblico effettivo del servizio. Prima di esporre l’applicazione è opportuno verificare anche la configurazione dell’autenticazione, dei permessi di accesso e delle copie di sicurezza.
Gnotes non si limita all’interfaccia web. L’applicazione può essere installata come app e continuare a funzionare offline, consentendo di modificare le note anche in assenza di connessione. Ogni appunto conserva inoltre una copia in formato Markdown semplice, mentre l’importazione permette di recuperare contenuti provenienti da Obsidian, Bear o da una cartella di file.
Per gli utenti Linux è disponibile anche un client nativo per GNOME basato su GTK, con modifica collaborativa in tempo reale e copie offline. Il progetto include infine una Agent API, che permette a script e agenti software autorizzati di leggere e modificare le note tramite una chiave API.
Grazie alla combinazione di self-hosting, Markdown, collaborazione e funzionalità opzionali di intelligenza artificiale, Gnotes può essere utilizzato per appunti personali, documentazione tecnica e raccolte di conoscenze condivise. La disponibilità di un client GNOME e il supporto offline ampliano le possibilità di utilizzo anche sui desktop Linux, mentre Docker semplifica la gestione del servizio su un server personale.
Abbiamo testato Gnotes su Arch Linux con ambiente desktop GNOME 51.