ospeak

OSPEAK

Openai 텍스트를 통해 연설 API를 통해 텍스트를 실행하고 결과 저장을위한 CLI 도구

이 프로젝트에 대한 배경에 대해서는 Openai를 통해 터미널에서 텍스트를 말하기위한 Ospeak : CLI 도구를 참조하십시오.

설치

pipx 사용 하여이 도구를 설치하십시오.

pipx install ospeak

MACOS에는 Python 3.12의 종속성이 깨졌습니다. 대신 실행하십시오.

pipx install --python /path/to/python3.11 ospeak

이 도구는 또한 ffmpeg 에 따라 다릅니다. 다음과 같이 홈브류를 사용하여 MacOS에 설치할 수 있습니다.

brew install ffmpeg

ospeak 에는 현재 LLM과 호환되지 않는 종속성이 있으므로 (이 문제 참조) 두 도구를 다른 가상 환경에 설치해야하므로 PIPX를 사용하는 것이 좋습니다.

용법

컴퓨터가 무언가를 말하도록하려면 실행하십시오.

ospeak " Hello there "

OpenAI API 키가 필요합니다. 환경 변수로 설정할 수 있습니다.

 export OPENAI_API_KEY= " ... "

또는 --token 사용하여 전달할 수 있습니다.

ospeak --token " ... " " Hello there "

컨텐츠를 도구에 파이프 할 수 있습니다.

 echo " Hello there " | ospeak

-v/--voice VOICE 사용하여 음성을 선택하십시오. 기본값은 alloy 입니다. 다른 옵션은 다음과 같습니다.

• echo
• fable
• onyx
• nova
• shimmer

당신은 -v all 통과하여 모든 목소리를들을 수 있습니다.

ospeak " This is my voice " -v all

-m/--model 옵션을 사용하여 다른 모델을 선택할 수 있습니다. 기본값은 tts-1 입니다. 오디오를 생성하는 데 약간 더 오래 걸리는 고품질 모델에 -m tts-1-hd 사용하십시오.

ospeak " This is higher quality " -m tts-1-hd

속도를 조정하려면 0.25와 4 사이의 값으로 -x/--speed (기본값은 1.0) :

ospeak " This is my fast voice " -x 2

파일에 오디오를 쓰려면 .mp3 또는 .wav 로 끝나는 파일 이름으로 -o/--output :

ospeak " This is my voice " -o voice.mp3

이것은 큰 소리로 말하지 않을 것입니다. 말하기를 원한다면 -s/--speak 옵션을 추가하십시오.

ospeak " This is my voice " -o voice.mp3 -s

Ospeak- 헬프

 Usage: ospeak [OPTIONS] [TEXT]

  CLI tool for running text through OpenAI Text to speech

  Set the OPENAI_API_KEY environment variable to your OpenAI API key to avoid
  using the --token option every time.

  Example usage:

      ospeak "Everyone deserves a pelican" --voice alloy -x 1.5

Options:
  --version                       Show the version and exit.
  -v, --voice [alloy|echo|fable|onyx|nova|shimmer|all]
                                  Voice to use
  -m, --model TEXT                Model to use - defaults to tts-1
  -o, --output FILE               Save audio to this file on disk
  -x, --speed FLOAT RANGE         Speed of the voice  [0.25<=x<=4.0]
  -s, --speak                     Speak the text even when saving to a file
  --token TEXT                    OpenAI API key
  --help                          Show this message and exit.

개발

이 도구에 기여하려면 먼저 코드를 체크 아웃하십시오. 그런 다음 새로운 가상 환경을 만듭니다.

 cd ospeak
python -m venv venv
source venv/bin/activate

이제 종속성 및 테스트 종속성을 설치하십시오.

pip install -e ' .[test] '

테스트를 실행하려면 :

pytest