ospeak

オスキーク

OpenAIテキストを介してテキストをスピーチAPIに実行し、結果をスピーキングまたは保存するためのCLIツール

このプロジェクトの背景については、Openai経由でターミナルでテキストを話すためのCLIツールを参照してください。

インストール

pipxを使用してこのツールをインストールします。

pipx install ospeak

MacOSには、Python 3.12を使用して壊れた依存関係があることに注意してください。代わりに実行してください。

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

このツールはffmpegにも依存します。このようなHomeBrewを使用してMacOSにインストールできます。

brew install ffmpeg

ospeakは現在LLMと互換性のない依存関係があるため（この問題を参照）、2つのツールを異なる仮想環境にインストールする必要があるため、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

OSPEK-ヘルプ

 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