tts joinery

tts-joiner

TTS-Joinery est une bibliothèque Python et un outil CLI pour contourner les limitations de longueur dans les API de texte vocal.

Étant donné que les API actuellement populaires sont limitées à 4096 caractères, cette bibliothèque:

• Chunchez le texte d'entrée dans les phrases à l'aide du module NLTK PUNKT (pour un meilleur son en évitant les segments divisés au milieu d'un mot ou d'une phrase).
• Exécutez chaque morceau à travers l'API TTS
• Rejoignez la sortie résultante pour produire un seul fichier MP3

Actuellement, seule l'API OpenAI est prise en charge, avec l'intention d'en ajouter plus à l'avenir.

Installation

pip install tts-joinery

ou utilisez pipx pour installer comme outil autonome.

Nécessite FFMPEG pour le traitement des fichiers audio.

L'installation peut varier en fonction de votre système. Sur Linux, vous pouvez utiliser votre gestionnaire de packages système. Sur Mac brew install ffmpeg devrait fonctionner.

Usage

Interface de ligne de commande (CLI)

La CLI prévoit de trouver une clé API OpenAI dans une variable d'environnement OPENAI_API_KEY , ou dans un fichier .env.

Syntaxe

 ttsjoin [OPTIONS] [COMMAND]

Options

 Options:
--input-file FILENAME   Plaintext file to process into speech, otherwise stdin
--output-file FILENAME  MP3 result, otherwise stdout
--model TEXT            Slug of the text-to-speech model to be used
--service TEXT          API service (currently only supports openai)
--voice TEXT            Slug of the voice to be used
--no-cache BOOLEAN      Disable caching
--help                  Show this message and exit.

Commands:
  cache [clear, show]

Exemples

1. Utilisation d'un fichier d'entrée et spécifiant un fichier de sortie:

ttsjoin --input-file input.txt --output-file output.mp3 --model tts-1 --service openai --voice onyx

2. Utilisation de STDIN et STDOUT avec des options par défaut:

 echo " Your text to be processed " | ttsjoin > output.mp3

3. Chaque morceau de texte est mis en cache pour les performances lors de l'exécution du même texte plusieurs fois, cela peut être désactivé:

ttsjoin --input-file input.txt --output-file output.mp3 --no-cache

5. Répertoire de cache effacer

ttsjoin cache clear

Bibliothèque python

Vous pouvez également utiliser TTS-Joiner dans le cadre de votre projet Python:

 import nltk

from joinery . op import JoinOp
from joinery . api . openai import OpenAIApi

# Only need to download once, handled for you automatically in the CLI
nltk . download ( 'punkt_tab' , quiet = True )

tts = JoinOp (
    text = 'This is only a test!' ,
    api = OpenAIApi (
        model = 'tts-1-hd' ,
        voice = 'onyx' ,
        api_key = OPENAI_API_KEY ,
    ),
)

tts . process_to_file ( 'output.mp3' )

Changelog

v1.0.4 (2024-10-11)

• Correction du problème avec la dépendance NLTK # 4
• Le modèle, la voix et le service CLI params sont désormais insensibles à la casse

v1.0.3 (2024-10-05)

• Ajout de commandes de gestion du cache à la CLI
• Correction d'un bug lors de l'exécution
• Des tests de bout en bout ajoutés

v1.0.2 (2024-10-03)

• Correction d'un crash en cours d'exécution avec la mise en cache désactivée (# 3)

Contributif

Les contributions sont la bienvenue, en particulier les autres API TTS, vérifient les problèmes à l'avance et n'hésitez pas à ouvrir un RP. Le code est formaté avec du noir.

Le test peut être exécuté manuellement. Suite comprend des tests de bout en bout avec des appels d'API en direct, vous assurer que vous avez un ensemble Openai_API_KEY dans .env.test et exécutez pytest . Vous pouvez installer des dépendances de développement avec pip install -e .[test]

Contributeurs

Un merci spécial à:

• Mayank Vishwakarma (@mayankwebbing)

Licence

Ce projet est autorisé sous la licence du MIT.

Copyright 2024, Adrien DeLessert