Audio Transcription

Audio Transcription

Trascrizione audio locale su qualsiasi piattaforma. La trascrizione avviene interamente sul computer dell'utente: il file audio non viene mai caricato online (solo il modello viene scaricato una volta, al primo uso). Adatto a materiale riservato.

Questo file è l'entry point: rileva la piattaforma e poi carica il reference della piattaforma corrispondente — i dettagli di installazione e i comandi sono lì, non qui (progressive disclosure).

Compatibilità runtime

Questa skill deve funzionare sia in ambienti Claude sia in ambienti OpenAI/Codex.

• Se stai operando in Claude Desktop, Claude for Work/Cowork o Claude Code: esegui i comandi tramite gli strumenti shell/terminale disponibili nell'ambiente Claude; se il runtime non consente comandi locali, fornisci istruzioni passo-passo all'utente.
• Se stai operando in Codex o in un ambiente OpenAI: esegui i comandi tramite gli strumenti shell disponibili nel workspace; se installazioni o download richiedono rete o permessi esterni, usa il flusso di approvazione del runtime prima di procedere.
• In ogni runtime, preserva l'obiettivo principale: trascrizione locale e nessun upload dell'audio a servizi esterni, salvo richiesta esplicita dell'utente.

Step 1 — Rileva la piattaforma

Esegui sempre questo comando per primo (funziona anche su Windows, dove uname non è affidabile):

python3 -c "import platform; print(platform.system(), platform.machine())"

Step 2 — Vai al reference della piattaforma

Sulla base dell'output, leggi il file references/ indicato e segui i suoi passi:

| Output del comando | Piattaforma | Tool | Reference da leggere | |---|---|---|---| | Darwin arm64 | Apple Silicon (M1+) | parakeet-mlx | references/apple-silicon.md | | Darwin x86_64 | Intel Mac | whisper.cpp | references/intel-mac.md | | Linux … (con o senza GPU NVIDIA) | Linux | faster-whisper | references/linux.md | | Windows AMD64 (con o senza GPU NVIDIA) | Windows | faster-whisper / whisper.cpp | references/windows.md |

Per la verifica GPU NVIDIA (Linux/Windows) usa nvidia-smi: se risponde con info sulla GPU → percorso CUDA (veloce); altrimenti → percorso CPU (più lento). I dettagli sono nei reference.

Note operative

• Lingua: per l'italiano i tool sono già impostati di default sui modelli giusti (Parakeet v3

multilingue EU, oppure Whisper --language it). I comandi nei reference lo riflettono.

• Formato di output: SRT è il default. Per ottenere anche VTT/TXT/JSON i reference indicano i

flag (--output-format all su parakeet-mlx; --output-srt su whisper.cpp; --output_format su faster-whisper).

• Velocità: su computer senza GPU NVIDIA (PC Windows/Linux comuni, Mac Intel) la

trascrizione gira sulla CPU ed è sensibilmente più lenta (indicativamente 5–20× più lenta di una GPU). Su quei sistemi suggerisci un modello più piccolo (small/medium) per ridurre i tempi. Apple Silicon e GPU NVIDIA sono molto più rapidi. Tabella tempi in references/troubleshooting.md.

• Problemi (download lento, .srt rinominato, ffmpeg/CUDA mancanti): references/troubleshooting.md.

Carica un solo reference per volta: quello della piattaforma rilevata. Consulta references/troubleshooting.md solo se emerge un errore.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: avvocati-e-mac
• Source: avvocati-e-mac/skill-legali
• License: MIT

Install and usage instructions live in the source repository linked above.