joplin/packages/transcribe

Installing

Configure Docker for transcribe

1. Copy .env-transcribe-sample to the location of your Docker configuration files.
2. Rename the file .env-transcribe-sample to .env-transcribe.
3. HTR_CLI_IMAGES_FOLDER should be a fullpath to the folder that is going to store the images
4. Run the following command to test starting the server using the default configuration:

docker build -f ./Dockerfile.transcribe -t transcribe .
docker run --env-file .env-transcribe -p 4567:4567 \
     -v /var/run/docker.sock:/var/run/docker.sock \
     -v ./packages/transcribe/images:/app/packages/transcribe/images \
     transcribe

Setup for development

Testing

The integration tests that require the full model to run don't run on the CI. It is necessary to be extra careful when changing the model or the prompt because of that. The specific test that has been disabled is at workers/JobProcessor.test.ts

Setup up the database

As the queue driver, we have the option of using SQLite or PostgreSQL, QUEUE_DRIVER can be set to pg or sqlite and QUEUE_DATABASE_NAME is the location of the SQLite file when using this configuration.

Starting the server

From packages/transcribe, run npm run start