Meinungsorgel

This is the repository for the webserver of the 'Meinungsorgel'. If you want to run the entire Meinungsorgel, you will need access to the following repositories:

1. smalldata_webserver: this one
2. smalldata_classification: model training
3. smalldata_proxy: a simple http-to-osc translater
4. SmallData: scripts for audio (SuperCollider) and visual (Processing) representation

Installation (development)

Backend

1. run git clone git@github.com:Regexose/SmallData.git
2. install python >= 3.8.0 (I recommend pyenv or virtualenv)
3. run pip install -r requirements.txt
4. download trained models (ideally from meinungsorgel.de) and put them in a folder trained_models in the model_data - folder
5. install postgres, create a db and a user (see Setup postgres-section in /doc/deployment.md). When using OSX, I suggest to use the PostGRes.app instead of homebrew installation
6. In the projects' root directory, create a copy of settings.ini.template, call it settings.ini. and edit with the correct values
7. run python manage.py makemigrations && python manage.py migrate
8. Load initial data into db by python manage.py loaddata fixtures/initial_fixture.yaml
9. install and start redis (brew install redis && brew services start redis)
10. start the api: python manage.py runserver

Frontend

1. cd into frontend, run npm install
2. inside frontend, create a file .env with content (or add urls of running server)

   REACT_APP_WS_URL = ws://localhost:8000/ws/
   REACT_APP_HTTP_URL = http://localhost:8000/api/
   

3. run npm run start
4. open browser & navigate to localhost:3000

Installation (production)

See doc/deployment.md

Management

Preperation (locally)

1. activate the python proxy - , i.e. websocket connection to forward incomming utterances to supercollider. Its located in the smalldata_utilities repo under proxy. Start it with

python proxy.py

If you have the felling something doesnt work with the communication,, try

python proxy.py --enable-trace

Start / stop webservice in production

Start backend & frontend

`~/start_meinungsorgel.sh`

To stop, use ~/stop_meinungsorgel.sh

Change language

Development

The language that the backend (API) uses to classify the incoming utterances is provided by the frontend: Each request to POST:/utterances provides a langauge code (currently de or en), that the backend uses to chose the correct model. This language code, in turn, is provided by the REACT_APP_LANGUAGE directive in the .env-file of the frontend-folder:

• en: use English language for classification
• de: use Germanlanguage for classification
• auto: use the Browsers' language setting for classification (English if the browser language is not implemented)

Production (meinungsorgel.de)

In production, the langauge is changed by running the set_langauge.sh - script in /home/smalldata/smalldata_webserver/scripts/ as smalldata:

ssh root@meinungsorgel.de
su smalldata
cd /home/smalldata/smalldata_webserver/scripts/
./set_language.sh de (bzw en / auto)
exit (ctrl+d)
~/start_meinungsorgel.sh

Warnings:

1. You need to add a language code as an argument to the script, i.e. type set_langauge.sh en (or de)
2. The script must be run as user smalldata, i.e. type su smalldata before
3. You have to restart gunicorn and nginx afterwards, or simply run /home/root/start_meinungsorgel.sh (as root)