Spectral is a toolkit that enables comparative analysis of atypical speech, with a nice user experience.
It is designed to be modular and extensible.
The easiest way to use the app is by accessing at https://spectral.ewi.tudelft.nl.
First, clone the repo:
git clone https://github/TBD/spectral.git
cd spectralDownload Docker and Docker compose following the instructions on the website.
(NOTE: For MacOS (especially Apple Sillicon), consider using colima as the runtime)
Then, run the compose file
docker compose up --build
This will pull the containers and install all dependencies. (NOTE: There is one Python dependency where wheels have to be rebuilt. This will likely take 5-10 minutes at least).
When all the containers are pulled and the dependencies built, the app should be available at localhost (i.e., http://localhost:80).
Spectral can be easily self-hosted on your own server.
Follow the steps above and expose port 80. You could also change the nginx config to host the app in a different port. That is, in nginx.conf change the "listen 80;" line to your desired port:
...
server {
- listen 80;
+ listen <YOUR-PORT>;
...
}
...If you really don't want two reverse proxies...
For more advanced users, if you are already using a reverse proxy then you can follow the configuration in the docker compose file and set up each service in your configuration.
For example, if you're already using compose then you can add the services with barely any changes to your existing compose file. This method as-explained is somewhat dubious fundamentally, but an advanced user can figure it out. Again, this is not really recommended nor officially supported by the project.
Contributions are welcomed. For more information, see the CONTRIBUTING.md
TODO