Per molte piccole imprese, studi professionali e agenzie la conoscenza operativa è dispersa tra chat, email, documenti sul desktop e appunti personali. Quando una persona cambia ruolo o un collaboratore esce, quel sapere sparisce. Vihko nasce per rispondere a questo problema con un approccio volutamente semplice: note in formato aperto, organizzate in spazi condivisi e ospitate su infrastruttura propria, invece che su un servizio cloud chiuso.
Cos'è Vihko: note in chiaro, senza database opaco
Vihko è un sistema di gestione della conoscenza self-hosted, distribuito come software open source con licenza dichiarata AGPL-3.0. A differenza di molte piattaforme di note che salvano i contenuti in un database proprietario accessibile solo tramite la loro applicazione, Vihko adotta un principio file-first: ogni nota è un file Markdown memorizzato su disco in modo leggibile e portabile.
Markdown è un linguaggio di marcatura leggero molto diffuso in ambito tecnico e documentale. Permette di scrivere testo formattato con titoli, elenchi, tabelle, link, immagini e blocchi di codice usando una sintassi semplice, leggibile anche senza rendering. Il fatto che le note siano file di testo ha conseguenze pratiche importanti: possono essere copiate, cercate con strumenti standard, versionate con Git, incluse in un backup ordinario del server e migrate senza procedure di esportazione complesse.
Dal punto di vista funzionale, Vihko si colloca nella famiglia dei wiki aziendali leggeri e delle alternative a strumenti come Notion, Evernote, Confluence o Google Docs, ma con una differenza architetturale di fondo. Non è un servizio in abbonamento da usare su server altrui: è un'applicazione da installare su un proprio server, su una macchina virtuale privata o su un'infrastruttura dedicata, così che i dati restino sotto il controllo diretto dell'organizzazione che li produce.
Il progetto prevede spazi condivisi per separare le aree di lavoro, funzioni di collaborazione tra più utenti e la possibilità di attivare API e interfacce per l'integrazione con altri strumenti, inclusa l'esposizione verso assistenti software tramite protocollo MCP in configurazioni opzionali. Non si presenta come suite completa di project management o come piattaforma di automazione, ma come strato di base per la memoria operativa del team.
A cosa serve nella pratica: manuali, procedure, progetti e passaggio di consegne
Per un founder o un responsabile di PMI, il valore di uno strumento come Vihko non sta tanto nella tecnologia quanto negli usi quotidiani che abilita. Il primo è la creazione di manuali operativi vivi: come si apre una pratica, come si gestisce un reclamo, come si configura un prodotto, come si prepara un preventivo, quali controlli fare prima di una consegna. Trasformare queste prassi tacite in pagine scritte, aggiornabili e ritrovabili riduce la dipendenza dalle singole persone e accelera l'inserimento di nuovi collaboratori.
Il secondo uso tipico è la gestione di riunioni e decisioni. Verbali sintetici, elenco delle azioni assegnate, scadenze e collegamenti alle note di progetto permettono di ricostruire perché è stata presa una certa decisione anche a distanza di mesi. Per agenzie creative, web agency, studi tecnici e società di consulenza questo è cruciale: ogni cliente genera decine di scelte e varianti che, se non documentate, diventano fonte di contestazioni e rilavorazioni.
Il terzo ambito è la documentazione per cliente e per commessa. Un'agenzia può creare uno spazio per cliente con brief, specifiche, materiali approvati, cronologia delle modifiche e istruzioni di manutenzione. Uno studio tecnico può raccogliere normative interne, checklist di sopralluogo e modelli di relazione. Una piccola azienda manifatturiera o di servizi può mantenere schede macchina, procedure di sicurezza, istruzioni per fornitori e registro delle non conformità.
Un quarto uso è la raccolta ordinata di idee e ricerca: analisi dei concorrenti, appunti da fiere ed eventi, prove di nuovi fornitori, bozze di contenuti per il sito e i social. Avere un luogo unico, ricercabile e condiviso evita che queste informazioni restino nei quaderni individuali o in chat effimere. Infine, Vihko può servire come base per procedure di continuità operativa: se un titolare o un tecnico chiave è assente, altri possono trovare le istruzioni essenziali senza doverlo chiamare.
Come funziona: file, spazi condivisi, collaborazione e integrazioni
L'architettura di Vihko può essere compresa in quattro livelli. Il primo è lo storage: le note sono file Markdown organizzati in cartelle sul file system del server. Questa scelta rende trasparente dove sono i dati e semplifica le operazioni di amministrazione. Un backup del volume dati è di fatto un backup della conoscenza. Chi ha già familiarità con Git può anche versionare la cartella delle note per tenere traccia di chi ha modificato cosa e per ripristinare versioni precedenti.
Il secondo livello è l'organizzazione in spazi. Uno spazio è un contenitore logico che raggruppa note affini, ad esempio Amministrazione, Commerciale, Produzione, Clienti, Guide interne o Laboratorio idee. Gli spazi permettono di separare le aree riservate da quelle condivise con tutto il team e di dare ordine alla crescita della base di conoscenza. All'interno di ogni spazio le note possono essere collegate tra loro con link interni, creando una piccola rete di pagine navigabile come un wiki.
Il terzo livello è la collaborazione. Vihko è pensato per l'uso multi-utente: più persone possono accedere via browser, creare e modificare pagine, condividere spazi e lavorare sulla stessa base documentale. Le funzioni esatte di permessi, cronologia e gestione utenti dipendono dalla versione installata e dalla configurazione dell'amministratore, ma il modello di riferimento è quello di un wiki aziendale: lettura e scrittura regolate per gruppi, con tracciabilità delle modifiche. Per organizzazioni italiane abituate a cartelle condivise senza regole, questo passaggio a spazi con titolari e responsabili di aggiornamento è spesso il vero salto di qualità.
Il quarto livello riguarda ricerca e integrazioni. La ricerca full-text sui file di testo consente di ritrovare rapidamente una procedura o un verbale senza ricordare dove era stato salvato. L'API opzionale permette di leggere e scrivere note da altri programmi, ad esempio per pubblicare automaticamente report o per sincronizzare documentazione generata da altri sistemi. L'interfaccia MCP opzionale, quando attivata, espone la base di conoscenza a strumenti di intelligenza artificiale in modo controllato, così che un assistente possa cercare risposte nei documenti interni invece di inventarle. Si tratta di funzioni da valutare con attenzione sul piano della sicurezza, aprendo l'accesso solo a ciò che è necessario e mantenendo separati spazi pubblici e riservati.
Dal punto di vista operativo, l'installazione tipica avviene su server Linux proprio o su macchina virtuale presso un fornitore scelto dall'azienda, con pubblicazione sicura via HTTPS, autenticazione e backup pianificato. Non richiede necessariamente database complessi o servizi esterni: la semplicità è parte del disegno.
Perché conta per founder, PMI e agenzie italiane: controllo, privacy e continuità
Per il contesto italiano ci sono quattro ragioni per cui un sistema come Vihko merita attenzione. La prima è il controllo dei dati. Molte PMI trattano informazioni sensibili: anagrafiche clienti, preventivi, contratti, procedure interne, dati tecnici. Mantenere questi testi su server sotto contratto diretto, in giurisdizione nota e con backup verificabili semplifica le valutazioni in ottica di protezione dei dati personali e di riservatezza commerciale. Non elimina gli obblighi di legge, ma rende più chiaro dove sono i dati, chi vi accede e come vengono conservati.
La seconda ragione è la lotta al lock-in. Quando la conoscenza aziendale vive solo dentro una piattaforma proprietaria, cambiare fornitore o ridurre i costi diventa difficile perché l'esportazione è parziale o perde formattazione e collegamenti. Con file Markdown standard, la migrazione resta possibile in qualsiasi momento con strumenti comuni. Per una PMI che ragiona su orizzonti di dieci o vent'anni, la leggibilità futura dei propri archivi è un criterio strategico, non solo tecnico.
La terza ragione è economica e organizzativa. I canoni per utente delle suite collaborative in cloud crescono con il team e con gli account esterni di collaboratori e stagisti. Un sistema self-hosted sposta il costo su hosting, manutenzione e backup, che per basi documentali di piccole dimensioni restano contenuti e prevedibili. Il confronto va fatto in modo onesto, includendo il tempo di amministrazione, ma per molte realtà da cinque a cinquanta persone il modello è sostenibile e scala senza sorprese legate al numero di licenze.
La quarta ragione è culturale: obbliga a scrivere e a mantenere. Strumenti semplici, veloci e ricercabili abbassano la barriera alla documentazione. Un titolare può chiedere che ogni attività ricorrente abbia una pagina con scopo, passi, responsabile e data di ultimo aggiornamento. Un'agenzia può definire che nessun progetto si chiude senza pagina di consegna e lezioni apprese. Nel tempo questo crea un patrimonio consultabile che migliora qualità, riduce errori ripetuti e rende più facile delegare.
Ci sono naturalmente dei limiti da considerare. Essendo un progetto giovane e focalizzato, non offre la ricchezza funzionale di suite affermate: automazioni avanzate, viste database, gestione attività complessa e app mobili mature potrebbero mancare o essere essenziali. La ricerca è basata su testo e non necessariamente semantica. La collaborazione in tempo reale sullo stesso paragrafo potrebbe essere meno fluida rispetto a editor cooperativi specializzati. E l'auto-ospitalità richiede disciplina su aggiornamenti, certificati, permessi e prove di ripristino.
Dove trovarlo, licenza e come valutarlo prima di adottarlo
Il codice sorgente del progetto è pubblicato su GitHub nell'area dell'autore, sotto il nome vihko, ed è accompagnato da documentazione per installazione e configurazione. La licenza dichiarata nei metadati è AGPL-3.0, una licenza copyleft forte pensata per il software di rete. In sintesi pratica: è possibile usarlo internamente e studiarlo liberamente, ma se lo si modifica e lo si mette a disposizione di terzi via rete, anche come servizio ospitato per clienti, scattano obblighi di condivisione del codice modificato alle condizioni della licenza. Per un uso puramente interno in azienda gli effetti sono limitati, mentre per un'agenzia che volesse offrirlo come servizio ai propri clienti è opportuna una verifica legale preventiva. In ogni caso conviene leggere il testo completo della licenza nel repository e non fermarsi ai riassunti.
Per valutarlo senza rischi, il percorso consigliato per una PMI è un pilota circoscritto di trenta giorni. Si installa un'istanza di prova su ambiente separato, si crea un numero ridotto di spazi, ad esempio Guide operative e Progetti, si importano alcune decine di documenti esistenti convertiti in Markdown e si coinvolge un piccolo gruppo di cinque o sei persone. Si misurano tre cose: tempo per ritrovare un'informazione, frequenza di aggiornamento delle pagine e riduzione delle domande ripetute al titolare o ai colleghi senior.
Sul piano tecnico, prima di un'adozione definitiva è utile verificare backup e ripristino con una prova reale, gestione di utenti e password con autenticazione robusta, uso di HTTPS, criteri per spazi riservati come buste paga o contratti, e strategia di importazione da strumenti precedenti. Se il pilota dimostra ordine e continuità, Vihko può diventare la memoria operativa dell'organizzazione: sobria, leggibile, portabile e sotto il proprio controllo.