Skip to content

foniafonia/vocaltrack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VocalTrack

Herramienta clínica de análisis y seguimiento vocal para logopedas.

Registra muestras de voz, extrae métricas acústicas objetivas y genera planes de intervención personalizados con detección de pitch en tiempo real.


¿Qué hace?

Análisis acústico

  • Extrae F0, jitter, shimmer, HNR y CPP con Praat (motor estándar en investigación vocal)
  • Validación cruzada de F0 con algoritmo PYIN (librosa) para mayor fiabilidad
  • Interpretación clínica orientativa por parámetro (verde/amarillo/rojo)
  • Detección automática de patrones: fatiga vocal, hipofonía, inestabilidad, lesión de masa...

Seguimiento longitudinal

  • Historial de sesiones por paciente
  • Gráficos de evolución entre sesiones
  • Informes PDF exportables con métricas y valoración clínica

Intervención vocal

  • Plan de ejercicios generado automáticamente según el perfil acústico
  • Durante cada ejercicio:
    • Piano de referencia — escucha la nota objetivo antes de practicar
    • Waveform en tiempo real — visualización de la forma de onda mientras grabas
    • Detección de pitch en vivo — Hz, nombre de nota, desviación en cents (♯/♭/✓)
    • Métricas por intento — jitter, shimmer, HNR, estabilidad calculados de la grabación
    • Feedback clínico accionable — "Nota alta +18¢ — Relaja la laringe" etc.
  • Recomendaciones en lenguaje claro para el paciente (sin jerga clínica)

Stack técnico

Capa Tecnología
Backend Python · FastAPI · SQLite
Análisis acústico Praat (parselmouth) · librosa
Frontend React · Vite · Tailwind CSS
Gráficos Recharts
Informes ReportLab (PDF)

Instalación

Requisitos

  • Python 3.10+
  • Node.js 18+
  • Praat instalado en el sistema

Backend

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

Frontend

cd frontend
npm install
npm run dev

La app estará en http://localhost:3000


Aviso clínico

Esta herramienta es un apoyo al seguimiento vocal, no un sistema de diagnóstico.

  • El análisis acústico no sustituye la exploración laríngea (videolaringoscopía, estroboscopía)
  • Los índices orientativos deben interpretarse junto con valoración profesional
  • Los umbrales de referencia son orientativos y varían por sexo, edad y contexto clínico
  • Los planes de intervención deben supervisarse por un logopeda cualificado

Autor

Desarrollado en el contexto del proyecto Logoped-IA — logopedia clínica + IA aplicada.

La IA es herramienta de apoyo. El criterio clínico es siempre del logopeda.

About

Herramienta clínica de análisis y seguimiento vocal: F0, jitter, shimmer, HNR, CPP + intervención con detección de pitch en tiempo real

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors