just-whisper 0.1.5

Whisper 🤫 sweet nothin's to your favorite LLM.

whisper 🤫

Visit the docs

::coverage

Supported Models

Provider Name	Supported by Whisper	Config Key
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:

pip 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