Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Intentio

Detti invece di scrivere. Tieni premuto un tasto, parli, rilasci: il testo compare dove stavi già lavorando — nella mail, nel messaggio, nel documento — con la punteggiatura giusta e senza gli "ehm".

La finestra principale

A cosa serve davvero

Parlare è più veloce che digitare, ma il parlato scritto così com'è non si può mandare a nessuno. Intentio si occupa della differenza.

Butti fuori il pensiero, esce già scritto bene. Detti una mail di venti righe camminando e la ricevi punteggiata, divisa in paragrafi, senza le ripetizioni e le false partenze. Non la devi risistemare.

Dici cosa ti serve, esce un prompt vero. Spieghi a voce e a ruota libera cosa vuoi da un'altra IA, e ne esce un'istruzione ordinata da incollare. Niente più prompt scritti male di fretta.

Selezioni un testo e gli parli. In qualsiasi app: evidenzi, tieni premuto un tasto e dici "accorcialo", "rendilo più formale", "traducilo in inglese". Il testo si riscrive al posto suo.

Impara i tuoi nomi. C'è un dizionario personale per le parole che la trascrizione sbaglia sempre: nomi di clienti, di prodotti, il gergo del tuo mestiere.

Perché sul tuo Mac e non su un server

La tua voce non esce dal computer. Non c'è un account da creare, non c'è un abbonamento mensile, e funziona anche senza connessione — dopo il primo avvio. Le cose che detti sono spesso quelle che non manderesti a un servizio esterno: qui il problema non si pone.

Requisiti

  • Mac con chip Apple (M1 o successivi). Non funziona sui Mac Intel: i modelli usano Apple MLX, che su Intel non esiste.
  • macOS 14 o successivo.
  • Circa 7 GB di spazio libero: 232 MB per l'app, il resto per i due modelli che si scaricano al primo avvio.
  • 16 GB di RAM consigliati. Con i modelli caricati l'app occupa circa 4,2 GB.

Installazione

  1. Scarica Intentio.dmg dall'ultima release.
  2. Aprilo e trascina Intentio dentro Applicazioni.
  3. Apri Intentio.

Al primo avvio macOS lo blocca

Succede a tutti, ed è normale: Intentio non è "notarizzata" da Apple, una procedura che richiede un abbonamento da sviluppatore a pagamento. macOS dice che non può verificare lo sviluppatore.

Per aprirla lo stesso: Impostazioni di Sistema → Privacy e sicurezza, scorri fino in fondo e premi Apri comunque.

(Il vecchio trucco del tasto destro → Apri non funziona più da macOS Sequoia.)

Poi parte la configurazione

Cinque passi, una volta sola:

  1. Controllo dei requisiti.
  2. Permessi: Microfono e Accessibilità. Servono entrambi — l'Accessibilità è quella che permette a Intentio di accorgersi del tasto mentre stai usando un'altra app, e di incollare il testo lì dentro.
  3. Lingua in cui detti.
  4. Download dei modelli, circa 6,4 GB. Si può interrompere e riprendere.
  5. Scelta dei tre tasti.

Come funziona dentro

Pezzo Cosa
Trascrizione Parakeet TDT 0.6b v3 via parakeet-mlx
Rete di riserva whisper.cpp con lingua fissa, quando Parakeet sbaglia lingua
Formattazione, prompt, riscrittura Qwen2.5 7B Instruct quantizzato a 4 bit, via mlx-lm
Interfaccia PyQt6 per le finestre, rumps per la barra dei menu
Storico SQLite in ~/Library/Application Support/intentio/

Tutti i modelli girano dentro il processo dell'app tramite Apple MLX. Non c'è un servizio esterno, non c'è un demone da avviare, non c'è nessuna chiamata di rete oltre al download iniziale dei modelli e al controllo degli aggiornamenti.

Limiti noti

  • Solo Apple Silicon. Non è una scelta: MLX non esiste su Intel.
  • Su Mac con più monitor la scritta nella barra dei menu può non comparire. È un difetto di macOS Tahoe con NSStatusBar che non siamo riusciti a risolvere. La barra fluttuante in basso resta visibile e mostra lo stato, quindi l'app è comunque utilizzabile. Se ti serve la voce nella barra dei menu, in Impostazioni → Schermo → Disposizione trascina la barra sullo schermo primario.
  • Il tasto fn funziona come tasto di dettatura solo se in Impostazioni → Tastiera imposti "Premi il tasto Globo per: non fare nulla".

Sviluppo

Serve uv.

git clone https://github.com/xSefirot/intentio
cd intentio
uv sync
./.venv/bin/python -m intentio.app

Controlli di qualità:

./scripts/lint.sh          # ruff + ty

Per costruire il pacchetto distribuibile, incluse le insidie di PyInstaller con MLX e le istruzioni per la firma: packaging/README.md.

Licenza

MIT — vedi LICENSE.

About

Detti invece di scrivere. Il testo compare dove stai lavorando, già con la punteggiatura e senza le esitazioni. Riscrive anche quello che selezioni. Tutto sul tuo Mac, nessun abbonamento.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages