Skip to content

demo

whisper 🤫

Visit the docs

Python 3.10 | 3.11 | 3.12 Ruff PyPI codecov Downloads License GitHub issues

Supported Models

Provider Name Supported by Whisper Config Key
GPT4All gpt4all
ChatAnthropic anthropic
ChatMistralAI mistral
ChatFireworks fireworks
AzureChatOpenAI azureopenai
ChatOpenAI openai
ChatTogether
ChatVertexAI
ChatGoogleGenerativeAI
ChatGroq
ChatCohere
ChatBedrock
ChatHuggingFace
ChatNVIDIA
ChatOllama
ChatLlamaCpp
ChatAI21
ChatUpstage
ChatDatabricks

Install

To install Whisper, you can use pip:

pipx install just-whisper

Setup

After installing Whisper, you need to initialize the configuration for Whisper. This involves setting up API keys for the services you intend to use, such as OpenAI or Anthropic.

To initialize the configuration, run:

$ whisper init

This will create a basic configuration file in your home directory (~/.whisper/whisper.toml). You should update this file with your API keys.

Setup with keys

If you have keys for OpenAI or Anthropic handy, you can initialize the configuration with:

$ whisper init --openai-key <your-openai-key> --anthropic-key <your-anthropic-key>

Config

The whisper config file is located at ~/.whisper/whisper.toml. It looks like this:

# ~/.whisper/whisper.toml

default = "openai"

[openai]
api_key = "sk-proj-..."
model = "gpt-3.5-turbo"

[anthropic]
api_key = "sk-ant-..."
model = "claude-3-opus-20240229"

Config Management

You can manage your config files using the whisper config command. For example...

Show Config

 whisper config show
UserConfig(
   default='openai',
   openai=OpenAIConfig(api_key='replace-me', model='gpt-3.5-turbo'),
   anthropic=AnthropicConfig(api_key='replace-me', model='claude-3-5-sonnet-20240620')
)

Get A Config Value

 whisper config get openai.model
gpt-3.5-turbo

Set A Config Value

 whisper config set openai.api_key "sk-proj-..."
UserConfig(
   default='openai',
   openai=OpenAIConfig(api_key='sk-proj-...', model='gpt-3.5-turbo'),
   anthropic=AnthropicConfig(api_key='replace-me', model='claude-3-5-sonnet-20240620')
)

Support Me :)

If you found this project helpful, please consider supporting me by buying me a coffee.

PayPal.Me

ETH: 0x329941cDc2D84ddDf3c0b9dB9791bc787e64AE4E

BTC: 3AVY6ySYGVJJHFo3ebrNYx9oSmqShLYrz8