GenPark Voice VAD

genpark-voice-vad

Heurísticas de energia e transcrição para detecção de fim de turno de voz.

Este é um detector de fim de turno baseado em heurísticas sobre energias dB pré-computadas e uma transcrição. Ele não decodifica áudio, transcreve fala nem executa um modelo VAD treinado. Os valores de confiança são pontuações heurísticas, não probabilidades calibradas.

Instalação a partir do release do GitHub

Python 3.9 ou mais recente. A biblioteca e o servidor MCP stdio não possuem dependências em tempo de execução.

python -m pip install https://github.com/Alpha-Park/genpark-voice-turn-taking-endpoint-detector-skill/releases/download/v1.0.1/genpark_voice_vad-1.0.1-py3-none-any.whl

A publicação no PyPI está pendente de configuração da conta. O projeto PyPI pretendido é genpark-voice-vad; não assuma que pip install genpark-voice-vad está disponível até que o projeto seja publicado.

Uso em Python

from genpark_voice_vad import VoiceTurnTakingEndpointDetector
client = VoiceTurnTakingEndpointDetector()
print(client.run_benchmark_turn_detection())

Configuração do MCP stdio

Após instalar o wheel, configure seu cliente MCP com o comando instalado:

{
  "mcpServers": {
    "genpark-voice-vad": {
      "command": "genpark-voice-vad",
      "args": []
    }
  }
}

Se o comando não estiver no PATH, use seu caminho absoluto ou python -m genpark_voice_vad com o mesmo interpretador onde você instalou o wheel. O release do GitHub também contém um pacote .mcpb para clientes que suportam extensões de desktop. Esse pacote requer um interpretador Python 3.9+ no PATH; ele inclui o código-fonte do servidor.

Ferramentas disponíveis: analyze_turn_status, calibrate_acoustic_thresholds, predict_semantic_closure, run_benchmark_turn_detection. tools/list retorna os argumentos obrigatórios e os esquemas JSON. Cada processo MCP mantém seu próprio estado. As ferramentas de benchmark usam instâncias isoladas.

Desenvolvimento

python -m unittest discover -s tests
python -m pip install mcp
python tests/check_mcp.py
python -m pip install build twine
python -m build
python -m twine check dist/*

python mcp_server.py --test executa o exemplo determinístico; não é um teste de conformidade de protocolo. A verificação do cliente MCP exercita initialize, tools/list, tools/call e ping via stdio.

Distribuição

O código-fonte e os artefatos de release do GitHub são a distribuição primária até que o PyPI seja configurado. Os envios para registros são acompanhados separadamente; um manifesto não é prova de aceitação no registro. Consulte PUBLISHING.md para o fluxo de trabalho PyPI repetível.

Licença MIT. Mantido por GenPark.