Voxtrama

In breve
Voxtrama è un'applicazione open source che gira in Docker sul tuo computer, e l'audio non esce mai da lì. Trascrive le registrazioni con Whisper, separa i parlanti e, con un modello servito da Ollama, scrive riassunto, decisioni, temi o concetti. Ogni punto porta la frase della registrazione e il minuto in cui è stata detta; quando la frase manca dalla trascrizione, il punto viene segnato Needs review.

Voxtrama trasforma le registrazioni che hai già, cioè riunioni, lezioni e interviste, in una trascrizione con i parlanti distinti e in un riassunto verificabile. Gira in Docker sul tuo computer, e l'audio resta lì. L'ho scritto io da zero in Python e l'ho pubblicato su GitHub il 28 settembre 2026, con licenza Apache 2.0. Come ogni punto del riassunto si lega alla frase e al minuto in cui è stata detta lo racconto nell'articolo sul verbale verificabile.

Voxtrama su GitHub sjpagan/voxtrama (si apre in una nuova scheda)

Chi sviluppa Voxtrama, e da quando

Cliente
Progetto personale
Settore
Riservatezza dei dati GDPR pubblica amministrazione
Ruolo
@sjpagan (Owner)
Anno
2026

Con che cosa è costruito Voxtrama

Python FastAPI Docker Ollama Redis SQLite

Quale problema risolve Voxtrama

Chi registra una riunione per farne il verbale oggi carica l'audio su un servizio esterno, e raramente sa su quale server finisce e per quanto tempo resta lì. Il riassunto che torna indietro è scritto da un modello linguistico, che può attribuire a qualcuno una frase mai pronunciata.

Come Voxtrama risolve il problema

Voxtrama porta trascrizione, separazione dei parlanti e riassunto sulla macchina di chi registra. Ogni punto del riassunto deve citare la trascrizione: Voxtrama cerca quella citazione parola per parola, collega il punto al minuto dell'audio e marca Needs review ciò che trova scritto in modo diverso.

Che risultati ha dato Voxtrama

Licenza Apache 2.0, codice e release su GitHub. È un'alpha: la uso sulle mie call di lavoro e cerco le prime persone che la provino.

Che fine fa l'audio

L'audio non esce mai dal tuo computer. Una registrazione caricata in Voxtrama fa questo percorso, dall'inizio alla cancellazione.

Momento Dove sta l'audio Che cosa esce in rete
Caricamento viene copiato nella cartella dei dati sull'host, ~/Voxtrama/recordings niente
Pulizia, trascrizione, separazione dei parlanti lo legge il processore della macchina niente
Riassunto resta sul disco: al modello arriva solo il testo della trascrizione il testo, verso il server Ollama che hai configurato; se Ollama è sulla stessa macchina, come nell'impostazione predefinita, niente
Conservazione resta nella cartella dei dati finché non lo cancelli niente
Cancellazione Delete › Audio sul job, Clean up, la retention, oppure rm -rf ~/Voxtrama niente

La retention è spenta in modo predefinito, quindi una registrazione resta sul disco finché non la cancelli tu o non imposti un limite di 7, 30, 90 o 365 giorni. Clean up rimuove da sola le registrazioni che nessun job usa, caricate da almeno una settimana.


A chi serve

Voxtrama serve a chi registra conversazioni su cui deve decidere o studiare, e vuole tenere l'audio in casa.

  • Un gruppo di lavoro che tiene i verbali delle riunioni, con decisioni, responsabili e scadenze.
  • Uno studio professionale o un ufficio pubblico, per cui il GDPR fa di questa scelta un obbligo.
  • Chi fa ricerca con le interviste e ne estrae i temi.
  • Uno studente che riascolta una lezione e ne vuole i concetti chiave.

A un'azienda che vuole Voxtrama sui propri server, o un workflow con la struttura dei suoi verbali, lo installo e lo adatto su misura.


Requisiti e installazione

Serve Docker: Docker Desktop su macOS, oppure Docker Engine con il plugin Compose su Linux. La memoria decide il modello di trascrizione: fino a 8 GB il più piccolo, fra 8 e 32 GB il medio, da 32 GB in su il più accurato. Per il riassunto serve Ollama con almeno un modello. La sola trascrizione funziona anche senza.

git clone https://github.com/sjpagan/voxtrama.git
cd voxtrama
cp .env.example .env
make up

make up avvia quattro container e stampa l'indirizzo, per esempio http://127.0.0.1:8000. Alla prima apertura Voxtrama propone il profilo adatto alla macchina e scarica il modello di trascrizione, 484 MB nel profilo più piccolo. I passi completi stanno nella wiki del progetto (si apre in una nuova scheda), alle pagine Requirements (si apre in una nuova scheda), Install-on-macOS (si apre in una nuova scheda) e Install-on-Linux (si apre in una nuova scheda).


I workflow: la finalità del riassunto

Un workflow dice a Voxtrama che cosa estrarre da una registrazione. Voxtrama ne porta tre, più la sola trascrizione:

Workflow Che cosa produce
meeting-decisions riassunto e decisioni, con responsabile, scadenza e citazione
lesson-companion riassunto e concetti chiave con la loro definizione
research-interview riassunto e temi, ciascuno con una citazione
transcribe-only solo la trascrizione con i parlanti

Un workflow è un file YAML, e funziona come una skill: la stessa call diventa un verbale di decisioni o una mappa dei temi a seconda del workflow e del modello che lo esegue. Per aggiungerne uno basta scriverlo, senza toccare il codice. Puoi definirne di tuoi accanto ai tre di serie, per esempio un verbale con la struttura richiesta dal tuo ufficio.


Che cosa esce in rete, e quando

Nessuna parte del codice spedisce il file audio fuori dalla macchina. In rete escono soltanto due cose, in due momenti precisi.

Connessione Quando Che cosa viaggia
huggingface.co solo quando Voxtrama scarica un modello che ancora non ha: al primo avvio, o al primo job che lo usa la richiesta dei file del modello; nessun audio e nessun testo
il server Ollama del riassunto a ogni riassunto il testo della trascrizione, verso il server che hai configurato: in modo predefinito è sulla stessa macchina

Per non far uscire niente basta tenere Ollama sulla stessa macchina. Se configuri un server remoto, a quel server arriva il testo della trascrizione, mai l'audio; la pagina Settings › Data & privacy mostra passo per passo dove gira ogni workflow, e un passo marcato local_only rifiuta i server remoti.

L'ho verificato il 30 settembre 2026 sui log di tre job eseguiti su giorgioserver. Il primo ha scaricato i due modelli e ha contattato huggingface.co tre volte, tutte per il download. Gli altri due job, con i modelli già sul disco, hanno contattato zero server esterni; il riassunto è andato all'Ollama della stessa macchina.

Il codice registra anche un difetto già corretto: il modello dei parlanti, pur essendo sul disco, interrogava huggingface.co quattro volte a ogni job per controllare i propri file. Nessun audio usciva, ma usciva l'informazione che quella macchina stava usando quel modello. Oggi il caricamento del modello avviene in modalità offline, e un test verifica che resti così.

Le altre protezioni stanno nel codice:

  • l'applicazione risponde soltanto su 127.0.0.1 e rifiuta le richieste con un nome host o un'origine diversi, anche contro il DNS rebinding;
  • una credenziale per il server del modello viaggia solo in https o verso la stessa macchina;
  • le versioni dei modelli scaricati sono fissate, perché SpeechBrain costruisce oggetti a partire dal file di configurazione del modello;
  • la retention cancella i job conclusi dopo 7, 30, 90 o 365 giorni.

La separazione dei parlanti vale per una registrazione alla volta: la stessa persona, in una call successiva, è di nuovo una voce senza nome. È una scelta. Un'impronta vocale è un dato biometrico, e conservarla trasformerebbe uno strumento di trascrizione in un sistema di identificazione. Per la stessa ragione Voxtrama lavora solo su file che hai già, e lascia alle piattaforme video i loro contenuti.


Che cosa fa ogni parte

Parte Tecnologia
Applicazione web e API Python 3.11, FastAPI, Jinja2
Coda dei job RQ su Redis
Database SQLite con le migrazioni di Alembic
Trascrizione faster-whisper (CTranslate2), int8 su processore
Separazione dei parlanti SpeechBrain ECAPA-TDNN, clustering con scikit-learn
Riassunto Ollama, locale o remoto
Riga di comando Typer: doctor, demo, run, compare, retention
Distribuzione Docker Compose, quattro container

I container sono la coda Redis, una migrazione del database che parte una volta sola, il server web e il worker che esegue i job. Tutto ciò che Voxtrama conserva sta in una cartella dell'host, ~/Voxtrama in modo predefinito: registrazioni, risultati, modelli, database e impostazioni.


Stato del progetto

Voxtrama è un'alpha. L'ho provato con Docker su un iMac Pro del 2017 con processore Intel e, il 30 settembre 2026, su un server Linux con un Ryzen 9 9950X: lì 30 minuti di audio hanno richiesto 10 minuti e 40 secondi, dalla trascrizione con large-v3 fino alle decisioni. Il prossimo passo è farlo girare su altri sistemi operativi. Fino alla 1.0 un aggiornamento può cambiare il formato dei workflow e dei job salvati, e le note di rilascio lo dicono. Mancano ancora le misure automatiche che impediscono a una release di peggiorare la qualità. L'interfaccia è in inglese e il codice è già pronto per le traduzioni: aspetto i primi riscontri d'uso per scegliere le lingue.

Rami e tag seguono il modello dei progetti di drupal.org, lo stesso dei miei moduli Drupal: un ramo per serie, 0.1.x, e tag da alpha a rc fino alla release.

Se lo provi, i riscontri mi servono sulle issue del repository.


Fonti

Tutte le fonti sono state consultate il 30 settembre 2026.

Modificato dall'AI

Questo contenuto è stato prodotto dall'AI e rivisto da una persona.

Come è stata usata l'AI?

Le bozze sono prodotte con l'assistenza dell'AI, poi dirette, rivedute e verificate da una persona. Numeri, date e versioni sono confrontati con le fonti pubbliche prima della pubblicazione, e la data di quel controllo è indicata nel testo.

Articoli su Voxtrama