Voxtrama
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.
Chi sviluppa Voxtrama, e da quando
Con che cosa è costruito Voxtrama
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 upmake 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.1e 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
httpso 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.
- Voxtrama su GitHub (si apre in una nuova scheda): README, licenza, requisiti, installazione, workflow, rami e tag, ricontrollato l'11 ottobre 2026. Fonte primaria.
- Changelog di Voxtrama (si apre in una nuova scheda): contenuto delle prime release. Fonte primaria.
- Release di Voxtrama (si apre in una nuova scheda): 0.1.0-alpha1 del 28/09/2026 e 0.1.0-alpha2 del 29/09/2026. Fonte primaria.
- Test sulle richieste a Hugging Face (si apre in una nuova scheda): le quattro richieste per job registrate prima della correzione, e il controllo che il modello dei parlanti resti offline. Fonte primaria.
- Caricamento del modello dei parlanti (si apre in una nuova scheda): la modalità offline forzata una volta scaricato il modello. Fonte primaria.
- Log dei job eseguiti su giorgioserver il 30/09/2026: richieste a huggingface.co solo nel job che ha scaricato i modelli. Misura dell'autore.
- SECURITY.md (si apre in una nuova scheda): ascolto su 127.0.0.1, controllo di host e origine, credenziali. Fonte primaria.
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
Come faccio il verbale di una riunione con l'AI tenendo l'audio sul mio computer, e verificando ogni punto?
Per fare il verbale di una riunione con l'AI senza far uscire l'audio servono tre passaggi sulla tua macchina: trascrizione, separazione dei parlanti, riassunto con un modello locale. Per fidarti del ...