# MedicalTranscription

## Getting started

### Prerequisites

1. ffmpeg for audio processing in Bumblebee's speech-to-text serving: `brew install ffmpeg`.
2. Postgres and pgvector for storing data and vector embeddings: `brew install pgvector`.

### Running the server

To start your Phoenix server:

  * Run `mix setup` to install and setup dependencies
  * Run `mix build_code_vectors` to download the ICD-9 codelist, precompute vectors, and store the results in the database.
  * Start Phoenix endpoint with `mix phx.server` or inside IEx with `iex -S mix phx.server`

Now you can visit [`localhost:4000`](http://localhost:4000) from your browser.

Ready to run in production? Please [check our deployment guides](https://hexdocs.pm/phoenix/deployment.html).

## Deployment

The app is configured to deploy to Fly.io via a `fly.toml` file. To deploy, run `fly deploy` within the app's directory.

### Precomputing code vectors

To build the code vectors for the ICD-9 codelist for the deployed environment:
1. Connect to the server with `fly ssh console`.
2. Run `/app/bin/medical_transcription eval MedicalTranscription.Release.precompute_code_vectors`. This will prepare the vectors in the database if they are not present.


## Run in Docker

1. Create a local volume: `docker volume create ml-data`
2. Ensure the volume is writeable: `docker run --rm -v ml-data:/data busybox /bin/sh -c 'touch /data/.initialized && chmod 1777 /data'`. More background:
  - What the initial `1` for `chmod` means: https://www.linuxnix.com/sticky-bit-set-linux/
  - How to update the permissions of a mounted volume: https://serverfault.com/a/984599
3. Build the image with: `docker build . -t headwayio/medical_transcription`
4. Run a container with: `docker run --env-file ./.env -p 4000:4000 headwayio/medical_transcription`

### Caveats

You may need to make a few changes to get the app running in Docker at the moment:
- In `lib/medical_transcription/application.ex`, comment out the `DNSCluster` child spec.
- In `rel/env.sh.eex`, comment out the `ERL_AFLAGS`, `RELEASE_DISTRIBUTION`, and `RELEASE_NODE` environment variables.

## Learn more

  * Official website: https://www.phoenixframework.org/
  * Guides: https://hexdocs.pm/phoenix/overview.html
  * Docs: https://hexdocs.pm/phoenix
  * Forum: https://elixirforum.com/c/phoenix-forum
  * Source: https://github.com/phoenixframework/phoenix