Ask or search…
K
Links
Comment on page

15 Second Quick-Start

This quick-start will guide you through packaging your python app with Streamlit and deploying it to Health Universe, the open-source health research cloud for ML/AI.

Prerequisites

  • An idea for a health application you'd like to create
  • Light familiarity with Streamlit
  • A GitHub account and a Health Universe account

Step 1: Create a GitHub repository

  1. 1.
    Create a new (public) repository on GitHub to host your project.
    • Repo is public
    • Repo has a readme.md
    • Use the "python" .gitignore template (to ignore .env)
  2. 2.
    Clone the repository to your local machine:
    git clone https://github.com/<your_account>/<your_repo_name>.git
  3. 3.
    Change to your project directory:cd <your_repo>
  4. 4.
    Create a virtual environment using: python -m venv .env
  5. 5.
    Activate your virtual environment with:
    source .env/bin/activate
  6. 6.
    Upgrade pip to make sure things go smoothly: python -m pip install --upgrade pip
  7. 7.
    Install the streamlit library with: pip install streamlit

Step 2: Create your python app

In your local repository, create the following files:
  • main.py: This file should contain your Python model.
  • requirements.txt: This file will list your project dependencies.
Next, learn a little bit about how Streamlit works.

main.py

import streamlit as st
st.title("Welcome to Health Universe!")
st.write("This is a sample application.")
alarm_clock = st.slider('hour', 0, 23, 17) # min: 0h, max: 23h, default: 17h
st.header(alarm_clock) # print in large text

requirements.txt

streamlit
# Include any other libraries required by your app.
Test out your app by running it locally:
Run your app locally using: streamlit run main.py

Step 3: Deploy to Health Universe

  1. 1.
    Push your local repo to GitHub.
  2. 2.
    Log in or create a Health Universe account if you haven't already.
  3. 3.
    Go to https://healthuniverse.com and navigate to "Apps."
  4. 4.
    Click "Add App" to create a new app.
  5. 5.
    Fill out the following fields:
    • App Name: Name of your app
    • Description: A brief description of your app
    • Github Account: Your GitHub username
    • Github Repo: The exact name of your GitHub repository
    • Main File: The name of your python file (usually main.py)
  6. 6.
    Click "Add App" to deploy your app. This process may take a few minutes.
Once you've completed these steps, your app will be published on Health Universe!

🥳🥳🥳