Description

TODO

Development

Requirements

• Python (version >= 3.8)

• pip, virtualenv

• git

• npm

• make (on Linux / Mac OS X -- optional)

Prepare development environment

Conda env

Create a conda/mamba environment, then install those packages:

mamba install -c conda-forge -c dharpa -c anaconda kiara kiara_plugin.network_analysis kiara_plugin.language_processing

We also need the duckdb package, because there is an issue with its conda package, we use pip (also, another package I forgot to add to the dependencies):

pip install duckdb json2html

Other dependencies

Then, we need two as of yet unreleased Python dependencies, so, with the activated conda/mamba environment, do:

pip install 'git+https://github.com/DHARPA-Project/kiara_plugin.html.git'
pip install 'git+https://github.com/DHARPA-Project/kiara_plugin.service.git'

(Optional) Populate the kiara data store with example data

This makes it easier to work on the frontend stuff, since there is no way yet to onboard data there. Conda env must also be activate for this step:

git clone https://github.com/DHARPA-Project/kiara.examples.git
kiara run kiara.examples/examples/pipelines/network_analysis/create_network_graph.yaml --save network
kiara run kiara.examples/examples/pipelines/topic_modeling/topic_modeling.yaml --save topic

Also, we need to create an example workflow called topic_modeling, otherwise the lumy frontend will error out:

kiara workflow create topic_modeling kiara.examples/examples/pipelines/topic_modeling/topic_modeling.yaml

Run kiara rest service

To confirm that this worked, you can run the kiara web service, then point your browser to the API documentation page:

• kiara service start
• open in browser: http://127.0.0.1:8080/schema/swagger#/

Play around a bit with the endpoints, and check out what is available at the moment. We can add endpoints on a 'as-needed' basis.

Lumy

Now for the JavaScript part:

# clone (or fork) this repository 
git clone https://github.com/makkus/lumy.git

# enter the project directory
cd lumy

# install dependencies
npm install

# run dev server (kiara service from above also needs to be started in other terminal)
npm run dev

Now open a browser for: http://127.0.0.1:5173/data

Copyright & license

This project is MPL v2.0 licensed, for the license text please check the LICENSE file in this repository.