MacOS Installation Guide

Installation Guide (MacOS)

1. To make the installation of dependencies easier, we need to install a package manager for MacOS called homebrew. To do this:
   • You need to first install XCode from Mac Store
   • Now, run the command:

     /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)”
     

2. Install python3 and pip3, using the command:

   brew install python3
   

3. To install python3 setuptools:
   • Go to python.org's download page and download the latest version’s zip file
     
   • Now change directory into the root folder of the downloaded zip and run setup.py using python 3:

     python3 setup.py
     

4. To install Aria2, run the command:

   brew install aria2
   

Sometimes, brew may not contain the package, if you get an error saying package not found, run the following commands

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null

brew install aria2   

5. Now you need to download the python modules required to run Bassa. Change directory to components/core and run command:

   python3 setup.py develop
   

6. For managing the Bassa databases, you need to install and setup mysql:

   • Run the commands-

     brew install mysql
     brew services start mysql
     mysqladmin -u root password 'enter-a-password-for-your-sql-server'
     

   • Enter the mysql terminal and create a database named Bassa:

     mysql -u root -p
     //Enter your sql server password
     mysql>> Create Database Bassa;
     mysql>> exit
     

   • Now change the working directory of terminal to root of Bassa. To import the data into the Bassa database, run-

     mysql -u root -p Bassa < Bassa.sql
     

7. For setting up the front-end, run the following command to install node, bower and gulp:

   brew install node
   npm install -g bower
   npm install -g gulp
   

8. To test the server, change directory to components/core and run the command:

   python3 Main.py
   

   While running the above the command, you might get errors saying some modules are not installed, try installing the modules by running

   pip3 install <module name>
   

9. Open a new terminal and navigate to the ui directory and run

   npm install
   

10. To start Bassa, run the command:

gulp serve
//For the admin account- username: rand and password: pass

Bassa should now be successfully running on your system. Refer to the 'How to use Bassa' wiki to know more about using it.