Abacus 1.0.0. initial set-up

Prerequisites for using Abacus

Check that you fulfil these requisites before Abacus set-up.

1. You have the NLP Virtual Machine installed and working, with your aura-nlpdata working branch generated.

2. The understanding model is already defined and configured.

3. You have generated the specific training files and E2E test files required for each stage of your NLP pipeline.

4. You have already filled the variables required for training in the configuration file build_local_variables.sh.

Steps for Abacus set-up

1. Access the NLP Virtual Machine.

2. Enter your local working project, henceforth {Root_project}, whose name should be:
   aura-nlpdata-[country-code]

3. Copy the local variables configuration template: "${Root_project}/tools/build_local_variables.sh.tpl"
   and rename as:
   "${Root_project}/tools/build_local_variables.sh"

   cd ${Root_project}/tools
   cp build_local_variables.sh.tpl build_local_variables.sh 
   

4. Access the file build_local_variables.sh in the tools/ folder.

5. Fill in the variables inside the “run_web_trainings” section:

   • TRAINING_WEB_AZURE_BASE_URL and TRAINING_WEB_AZURE_SAS_TOKEN variables:
     Ask the APE Team for them.

   • GITHUB_TOKEN variable:

     • Generate a GitHub token:

       • Enter GitHub with your profile
       • Verify your email address if you haven’t done it yet
       • Go to GitHub token settings and generate a new token
       • Fill in the name and expiration date of the token
       • Select the scopes (Recommended: activate repo)
       • Click Generate token

     • Copy the token in the variable GITHUB_TOKEN.
       ⚠️ Make sure you copy it, as it will only shown once.

     

6. Run the script file:

   ${Root_project}/tools/run_web_trainings.sh
   

7. When the script is finished, Abacus is opened automatically.