rajdip-b / akello

Population health infrastructure for absolutely everyone

What's Akello?

Akello enables clinical services to run and bill for Collaborative Care (CoCM). It's an open-source platform that features:

• A streamlined Patient Registry.
• Easy management of multiple registries.
• Customizable tools for population assessment.
• Efficient time tracking for billing.
• Easy to customize styles and branding.
• AWS Infrastructure scripts to host and run your own registry.

Overview of the Repo

Folder structure

akello/
├── agent                  # automated workflows / AI enablement
├── apps                   # client web and mobile apps
├── aws_cloudstack         # AWS CDK scripts to setup akello infra
├── examples               # end-to-end examples using akello packages
├── packages   
│   ├── cdk                # AWS CDK scripts to setup infrastructure
│   ├── docs               # docs hosted under docs.akello.io
│   ├── react-fhir         # React components designed for FHIR resource types
│   ├── react-insights     # React components for anything related to data/charts/insights
│   ├── react-medical      # React components for anything clinical (screeners, registry, etc)
├── scripts                # General helper scripts (placeholder for now)
└── servers                 
│   ├── api-server         # Fast API server
│   ├── fhir-server        # FHIR Server

Setting up your local environment

⚠️ You shouldn't need to use aws for local install: Make sure you have Docker installed, there will be two Docker Containers running after you run the dev-setup script

REQUIRED SOFTWARE

• Python
• Node

Run the setup local script and add the environment variables into your environment file (e.g., ~/.zshrc)

Sets up Local instance of DynamoDB and AWS Cognito

sh dev-setup-local.sh 

From one terminal run the api server

python akello.py run server

In another terminal run the web-app

python akello.py run cocm

Run the API server

cd servers/api-server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn akello.main:app --reload

Run the React app

cd apps/cocm-registry
npm install
npm run start

When you signup as a new user, the local SMS confirmation code is set to 1234 for local development

Setup python environment from the root directory

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

sh dev-setup-local.sh
python akello.py setup
python akello.py start server 
python akello.py start cocm  # run this in another terminal, make sure to apply the environment settings

License

Apache 2.0

Copyright © Akello Health 2024

FHIR® is a registered trademark of HL7.

SNOMED® is a registered trademark of the International Health Terminology Standards Development Organisation.

LOINC® is a registered trademark of Regenstrief Institute, Inc.

DICOM® is the registered trademark of the National Electrical Manufacturers Association (NEMA).