Skip to content
Whishper

Configure Whishper

For the time being, Whishper configuration is small. All the configuration is done through environment variables. You can see the list of available variables in the env.example file.

The following table describes the available variables:

VariableDescriptionDefault valueVersion
LT_LOAD_ONLYThe language codes that will be available for translations. This will download the languages (or any new ones added) on the first run.es,en,frany
WHISPER_MODELSThe Whisper models to download by default.tiny,smallany
WHISHPER_HOSTThe hostname where Whishper is being served, without the protocol.localhost:8082any
CPU_THREADSThe number of CPU threads to use when transcribing.4>= v3.1.2
DB_USERThe username for the database.rootany
DB_PASSThe password for the database.exampleany
FERRETDB_ENABLEDIf you are using FerretDB instead of MongoDB, put any value to this variable. Otherwise remove it.-any

LT_LOAD_ONLY

This variable defines the translation models that will be downloaded on the first run. The default value is es,en,fr, which means that the models for Spanish, English and French will be downloaded, with translation pairs (i.e. Fr->Es, Fr->En…). If you want to download more models, you can add them to the list, separated by commas.

Note that the vaue is the two letter language code, not the full language name.

If you want to download all 60 translation models, you can set the variable to "" (it is needed to specify an empty value).

WHISPER_MODELS

This variable defines the Whisper models that will be downloaded on the first run. The default value is tiny,small, which means that the models for the tiny and small models will be downloaded. If you want to download more models, you can add them to the list, separated by commas.

The available models are: tiny, tiny.en, small, small.en, medium, medium.en, large-v2, large-v3.

WHISHPER_HOST

This variable defines the host where Whishper is being served. It is used for the websocket connection, and some client-side connections. So it must be the host that the end user is using to access Whishper.

COMPOSE_PROFILES

This variable defines if Whishper should use the GPU containers or not. By default, it is set to cpu, which means that Whishper will only use CPU. If you want to enable GPU with CUDA, read the documentation and set it to gpu.