π§βπ»Running in development mode
Follow these instructions to run Kuwala in development mode.
1.1 Prerequisites
To run the backend, you need to have Python 3.9 (we're using v3.9.5) installed.
1.2 Installation
First, install the dependencies in a new virtual environment by running the following command from inside the kuwala/core/backend directory:
DBT_PSYCOPG2_NAME=psycopg2 pip install --no-cache-dir -r requirements.txt --no-binary dbt-postgres
To set up a new virtual environment, you can follow the steps outlined here.
First, start the backend database by running the following command from inside the root directory of the repository:
docker-compose --profile backend_database up
After you installed all requirements, you can launch the API by running the following command from inside the kuwala/core/backend directory:
To force the API server to reload everytime when code changes have been detected, simply pass --dev=True as a parameter when launching the API.
python3 app/main.py --dev=True
Important: You need to set the following environment variables:
2.1 Prerequisites
To run the frontend, you need to have Node.js (we're using v16) together with npm installed.
2.2 Installation
Install the dependencies by running the following command from inside the kuwala/core/canvas directory.
To launch the frontend, run:
Now open http://localhost:3000 in your browser, and you are good to go. π