aws text to speech

Serviço de conversão de texto em fala sem servidor da AWS (Python)

Site de blogs

Detalhes de contato | [email protected]

Características

• Um serviço sem servidor que pega arquivos de texto carregados em um bucket, converte-os em MP3 e envia a saída para um endereço de e-mail
• Usa Amazon Polly
• Serviço Python Serverless com uma estrutura de arquivos recomendada.
• Pipelines CI/CD baseados em ações do Github com linters python, análise de código estático, verificações de complexidade e formatadores de estilo.
• Pastas de testes unitários, de integração e E2E prontas para implementação.

Este não é um código pronto para produção, mas sim um POC avançado.

Eu o uso para converter o texto do meu blog em áudio por motivos de acessibilidade.

Ele carrega qualquer arquivo de texto na pasta /text para o S3, transforma-os em arquivos .mp3 e os envia de volta para um endereço de e-mail.

O endereço de e-mail está codificado no arquivo service/logic/email.py e pode ser alterado.

Aqui está um mergulho profundo no design: https://www.ranthebuilder.cloud/post/serverless-empowers-accessibility-convert-text-to-speech-with-amazon-polly

Importante: certifique-se de ativar o SES para enviar e-mails para o endereço de e-mail escolhido https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html

Quem me deu essa ideia?

Fiquei inspirado a projetar uma solução para mim mesmo depois de ver este excelente vídeo no YouTube de Johannes Koch e Jimmy Dahlqvist.

Projeto

Para o design do serviço e mais informações, confira minha postagem no blog aqui.

Arquitetura

Fluxo de eventos:

• O arquivo de texto é carregado no S3
• Uma função Lambda é acionada com um evento 'criar objeto'.
• A função Lambda lê o arquivo de texto e usa o wrapper AWS Polly para iniciar uma tarefa polly de conversão de texto em fala que salvará a saída do bucket de origem como um arquivo .mp3
• A função Lambda aguarda a conclusão da tarefa pesquisando o status da tarefa
• Depois de concluído, a função baixa o arquivo e o envia como anexo de e-mail para um endereço de e-mail de sua escolha

Considerações de projeto

1. Por que uso a função Lambda? Por que não uma função escalonada?

Isso é definitivamente uma melhoria, mas foi apenas um POC rápido para automatizar minhas necessidades pessoais e fornecer um exemplo de código para uma postagem no blog.

Em um código de produção, você deve usar uma máquina de estado de função de etapa que aguarda até que a tarefa seja concluída.

2. Por que envio o arquivo por e-mail, pois ele já está no bucket?

Para minhas necessidades, desejo fazer upload do arquivo mp3 para meu site e removê-lo de minha conta pessoal da AWS. Você pode alterar o comportamento como desejar.

Começando

Pré-requisitos

• Docker - instale o Docker. Necessário para o processo de empacotamento da camada Lambda.
• AWS CDK – necessário para sintetizar e implantar a pilha AWS Cloudformation.
• Pitão 10
• poesia - Certifique-se de executar poetry config --local virtualenvs.in-project true para que todas as dependências sejam instaladas na pasta '.venv' do projeto.
• Para máquinas baseadas em Windows, use a versão Makefile_windows (renomeie para Makefile). Makefile padrão é para Mac/Linux.

Criando um ambiente de desenvolvedor

1. Execute make dev
2. Execute poetry install

Implantar CDK

Crie uma pilha de cloudformation executando make deploy .

Excluindo a pilha

CDK destroy pode ser executado com make destroy .

Preparando código para relações públicas

Execute make pr . Este comando executará todas as verificações necessárias, ganchos de pré-commit, linters, formatos de código, flake8 e testes, para que você possa ter certeza de que o pipeline do GitHub será aprovado.

O comando corrige automaticamente erros no código para você.

Se houver um erro no estágio de pré-confirmação, ele será corrigido automaticamente. No entanto, é necessário executar make pr novamente para que ele continue nas próximas etapas.

Certifique-se de confirmar todas as alterações que make pr faz para você.

Construindo dev/lambda_requirements.txt

lambda_requirements.txt

O CDK requer um arquivo requirements.txt para criar um arquivo zip com as dependências da camada Lambda. É baseado no arquivo poetes.lock do projeto.

O comando ``make deploy` irá gerá-lo automaticamente para você.

dev_requirements.txt

Este arquivo é usado durante o GitHub CI para instalar todas as bibliotecas Python necessárias sem usar poesia.

O conteúdo do arquivo é criado a partir do Pipfile.lock.

Os comandos make deploy make deps geram-no automaticamente.

** Como transformar um arquivo de texto em fala?

Coloque um arquivo de texto (.txt) na pasta /text. Implante a pilha CDK com o comando 'make deploy'.

Ele será carregado em um bucket S3 e transformado em um arquivo mp3 enviado a você por e-mail.

O endereço de e-mail é codificado e pode ser encontrado no arquivo service/logic/email.py.

Ao adicionar um novo arquivo: você pode fazer upload diretamente para o bucket ou adicioná-lo à pasta /text e executar 'make deploy'.

Contribuições de código

Contribuições de código são bem-vindas. Leia este guia.

Código de Conduta

Leia nosso código de conduta aqui.

Conectar

• E-mail: [email protected]
• Site do blog RanTheBuilder
• LinkedIn: ranisenberg
• Twitter: IsenbergRan

Créditos

• Exemplos de wrapper AWS Polly (Python)

Licença

Esta biblioteca está licenciada sob a licença MIT. Veja o arquivo LICENÇA.