{"id":19428769,"url":"https://github.com/syn54x/whisper","last_synced_at":"2025-04-24T18:31:25.542Z","repository":{"id":257807224,"uuid":"865661451","full_name":"syn54x/whisper","owner":"syn54x","description":"Whisper 🤫 sweet nothin's to your favorite LLM.","archived":false,"fork":false,"pushed_at":"2024-10-25T03:03:52.000Z","size":1741,"stargazers_count":5,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-26T16:21:45.802Z","etag":null,"topics":["assistant-chat-bots","cli","generative-ai","llm","python"],"latest_commit_sha":null,"homepage":"https://syn54x.github.io/whisper/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/syn54x.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-30T22:52:31.000Z","updated_at":"2024-10-25T03:03:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"950f760c-e596-41d1-a498-8e929286f9c9","html_url":"https://github.com/syn54x/whisper","commit_stats":null,"previous_names":["syn54x/whisper"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syn54x%2Fwhisper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syn54x%2Fwhisper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syn54x%2Fwhisper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syn54x%2Fwhisper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/syn54x","download_url":"https://codeload.github.com/syn54x/whisper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223961132,"owners_count":17232251,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assistant-chat-bots","cli","generative-ai","llm","python"],"created_at":"2024-11-10T14:16:27.434Z","updated_at":"2024-11-10T14:16:28.196Z","avatar_url":"https://github.com/syn54x.png","language":"Python","funding_links":["https://paypal.me/syn54x?country.x=US\u0026locale.x=en_US"],"categories":[],"sub_categories":[],"readme":"![demo](https://github.com/user-attachments/assets/40130388-2452-4902-9bca-2fb76ad79ffe)\n\n# `whisper` 🤫\n\n[Visit the docs](https://syn54x.github.io/whisper/)\n\n![Python 3.10 | 3.11 | 3.12](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12-blue.svg)\n![Ruff](https://img.shields.io/badge/linted%20by-ruff-FFC107.svg)\n![PyPI](https://img.shields.io/pypi/v/just-whisper)\n[![codecov](https://codecov.io/gh/syn54x/whisper/branch/main/graph/badge.svg)](https://codecov.io/gh/syn54x/whisper)\n![Downloads](https://img.shields.io/pypi/dm/just-whisper)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n![GitHub issues](https://img.shields.io/github/issues/syn54x/whisper)\n\n## Supported Models\n\n| Provider Name                | Supported by Whisper | Config Key |\n|------------------------------|----------------------|------------|\n| GPT4All                      | ✅                   | gpt4all    |\n| ChatAnthropic                | ✅                   | anthropic  |\n| ChatMistralAI                | ✅                   | mistral    |\n| ChatFireworks                | ✅                   | fireworks  |\n| AzureChatOpenAI              | ✅                   | azureopenai|\n| ChatOpenAI                   | ✅                   | openai     |\n| ChatTogether                 | ❌                   |            |\n| ChatVertexAI                 | ❌                   |            |\n| ChatGoogleGenerativeAI       | ❌                   |            |\n| ChatGroq                     | ❌                   |            |\n| ChatCohere                   | ❌                   |            |\n| ChatBedrock                  | ❌                   |            |\n| ChatHuggingFace              | ❌                   |            |\n| ChatNVIDIA                   | ❌                   |            |\n| ChatOllama                   | ❌                   |            |\n| ChatLlamaCpp                 | ❌                   |            |\n| ChatAI21                     | ❌                   |            |\n| ChatUpstage                  | ❌                   |            |\n| ChatDatabricks               | ❌                   |            |\n\n\n## Install\n\nTo install Whisper, you can use pip:\n\n```console\npipx install just-whisper\n```\n\n## Setup\n\nAfter 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.\n\nTo initialize the configuration, run:\n\n```console\n$ whisper init\n```\n\nThis will create a basic configuration file in your home directory (`~/.whisper/whisper.toml`).  You should update this file with your API keys.\n\n### Setup with keys\n\nIf you have keys for OpenAI or Anthropic handy, you can initialize the configuration with:\n\n```console\n$ whisper init --openai-key \u003cyour-openai-key\u003e --anthropic-key \u003cyour-anthropic-key\u003e\n```\n\n## Config\n\nThe whisper config file is located at `~/.whisper/whisper.toml`.  It looks like this:\n\n```toml\n# ~/.whisper/whisper.toml\n\ndefault = \"openai\"\n\n[openai]\napi_key = \"sk-proj-...\"\nmodel = \"gpt-3.5-turbo\"\n\n[anthropic]\napi_key = \"sk-ant-...\"\nmodel = \"claude-3-opus-20240229\"\n```\n\n### Config Management\n\nYou can manage your config files using the `whisper config` command.  For example...\n\n#### Show Config\n\n```bash\n❯ whisper config show\nUserConfig(\n│   default='openai',\n│   openai=OpenAIConfig(api_key='replace-me', model='gpt-3.5-turbo'),\n│   anthropic=AnthropicConfig(api_key='replace-me', model='claude-3-5-sonnet-20240620')\n)\n```\n\n#### Get A Config Value\n\n```bash\n❯ whisper config get openai.model\ngpt-3.5-turbo\n```\n\n#### Set A Config Value\n\n```bash\n❯ whisper config set openai.api_key \"sk-proj-...\"\nUserConfig(\n│   default='openai',\n│   openai=OpenAIConfig(api_key='sk-proj-...', model='gpt-3.5-turbo'),\n│   anthropic=AnthropicConfig(api_key='replace-me', model='claude-3-5-sonnet-20240620')\n)\n```\n# Support Me :)\n\nIf you found this project helpful, please consider supporting me by buying me a coffee.\n\n[PayPal.Me](https://paypal.me/syn54x?country.x=US\u0026locale.x=en_US)\n\nETH: `0x329941cDc2D84ddDf3c0b9dB9791bc787e64AE4E`\n\nBTC: `3AVY6ySYGVJJHFo3ebrNYx9oSmqShLYrz8`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyn54x%2Fwhisper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyn54x%2Fwhisper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyn54x%2Fwhisper/lists"}