Contains the tool for viewing valency frames and adding user-defined senses to underlying sentences.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
voje b4db4e5255 docker stack deployment 2 years ago
flask_app frontend_devops fix 2 years ago
valency modifying frames api 2 years ago
vue_frontend frontend_devops fix 2 years ago frontend_devops fix 2 years ago frontend_devops fix 2 years ago frontend_devops fix 2 years ago frontend_devops fix 2 years ago frontend_devops fix 2 years ago

Izdelava vezljivostnih vzorcev za slovenske glagole

Študent: Kristjan Voje

Mentor: prof. Marko Robnik Šikonja Somentorica: dr. Apolonija Gantar


  • Linux (built and tested on Ubuntu 16.04),
  • python3

Quick workspace preparation

# Clone the repo.
$ git clone

# Prepare the data.
$ cd ./data
$ unzip

Virtualenv recommended. $ sudo pip3 install virtualenv.

$ cd ./script
$ virtualenv -p /usr/bin/python3 venv

# A folder venv with python libraries will appear.  
# To activate the virtual environment:  
$ source ./venv/bin/activate

# To deactivate: 
$ deactivate

Now, to build the python packages:

# Polyglot dependencies
$ sudo apt-get install libicu-dev
# NOTE: installing this broke my Arch system.
# If on Arch, use the AUR version (it's supposed to be safe).

$ cd ./script
$ pip3 install -e .

# Polyglot downloads
$ polyglot download

To test the installation, fire up a python3 shell (while in virtualenv) and:

import valency

Nodejs environment

There's a compiled front end client in the git repo. In case you want to change anything, you'll need to set up the development environment:

  • install nodejs (default Ubuntu versions are usually behind),
  • check $ npm -v, if you don't have it, install npm,
$ npm install vue-cli
$ cd ./vue_frontend
$ npm install
$ npm run dev  # for development
$ npm run build  # for production

You will also need to change some path variables if you'll want to access the backend api from vue development server. See chapter "Web app deployment".


Set up the database on the system

install MongoDB on Linux

The MongoDB instance stores its data files in /var/lib/mongodb and its log files in /var/log/mongodb by default, and runs using the mongodb user account. You can specify alternate log and data file directories in /etc/mongod.conf. See systemLog.path and storage.dbPath for additional information.

If you change the user that runs the MongoDB process, you must modify the access control rights to the /var/lib/mongodb and /var/log/mongodb directories to give this user access to these directories.

Check if it's working.

$ sudo service mongod start / stop / restart
$ tail -n 30 /var/log/mongodb/mongod.log

# If you want the mongo shell on local machine:
$ mongo --host<27017> # Check net.port in /etc/mongod.conf


Create admin and user. Localhost only. sedurity man Basically, create an admin user then user that admin to create a normal user. Something like this:

use admin

    user: "admin_name",
    pwd: "admin_pass",
    roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]

# Restart mongod.

use texts

    user: "user_name",
    pwd: "user_pass",
    roles: [ { role: "readWrite", db: "texts" } ]

# Restart mongod.

# Also useful

Then go to /etc/mongod.conf and add this: Do not use tabs! mongod won't start.

 authorization: enabled

You need to use <db>, db.auth("username", "pass") to have access.

DB migration

I installed mongo on remote with same user accounts as on local.

# On local.
$ mongodump --db texts --host --port 3017 --username user --password "pass" --out ./file.db

# Rsync it over to remote.
# On remote.
# Need to turn off authorization for the drop part.

$ mongorestore --db texts --drop --port <port> ./<dbfolder>

DB collections, needed for web app

  • v2_senses,
  • v2_senses_map,
  • v2_users,
  • v2_user_tokens
  • sskj

Web app deployment

We need to set flask to serve the vuejs frontend:

# in ./script/flask_app/
app = Flask(

Set the correct CORS options.

Might need to reinstall the package. Make sure you're in python virtualenv. $ pip3 install -e .

We also need to tell vuejs client to look for the api on server's address.

// in script/vue_frontend/src/main.js
api_addr: "http://<my_server_addr>:5004",

Compile frontend client:

$ cd ./script/vue_frontend
$ npm run build
$ rm ../flask_app/vue -rf
$ cp ./dist ../flask_app/vue -r

After preparing frontend, backend and database, run the command:

$ cd ./script
$ ./

When fixing things in dev environment:

## Backend
# git clone everything
$ cd script

# unzip some zipped files
$ ./sherpa --unpack

# virtualenv
$ source venv/bin/activate
$ pip3 install -e .

# start a mongod instance
$ sudo systemctl start mongod

# start the backend server
$ ./ --debug

# you can watch the logs with
$ tail -f log/main.log

## Frontend
# set the right config file (path to api)
$ ./sherpa --frontend_config dev
$ cd vue_frontend
$ npm run dev

## Done making changes
# build frontend for production with the right config files
$ ./sherpa --build_vue

# if you've made changes to static .pickle files
$ ./sherpa --pack