Streamlit Quick-Start

This quick-start will guide you through packaging your python app with Streamlit and deploying it to Health Universe. You will need to have a GitHub account to create your repository.

Step 1: Create a GitHub repository

1. Create a new repository on GitHub to host your project. You can make the repository either public or private, and it is a good idea to have a readme.md file in the repository and use a .gitignore template so that you can ignore the .env. This is important when you're linking a local development environment to a github repository.

   • Repo contains main.py and requirements.txt

   • Repo has a readme.md

   • Use the "python" .gitignore template (to ignore .env)

   Note: If you're using a local development environment, link your local environment to your GitHub repository

2. Clone the repository to your local machine:

   git clone https://github.com/<your_account>/<your_repo_name>.git

3. Change to your project directory:

   cd <your_repo>

4. Create a virtual environment using: python -m venv .env

5. Activate your virtual environment with:

   source .env/bin/activate

6. Upgrade pip to make sure things go smoothly: python -m pip install --upgrade pip

7. Install the streamlit library with: pip install streamlit

If you're using ChatGPT (or editing directly into GitHub)

You will need to have at minimum a main.py file, and a requirements.txt file. you can copy/paste code into these files directly in GitHub.

1. Create a main.py file in your repository. This is where your code should reside.

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

1. Create a requirements.txt file. For streamlit, it should include (at a minimum) Streamlit as a requirement.

streamlit
# Include any other libraries required by your app.

Make sure that you commit any changes that you make before you deploy with health universe.

Step 2: Create your python app within your local environment

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.

• Overview of the main concepts for creating UI with Streamlit.
• Here's a nifty cheat sheet for all the interface elements you can create.

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. Push your local repo to GitHub.

2. Log in or create a Health Universe account if you haven't already.

3. Go to https://healthuniverse.com and navigate to "Apps."
4. Click "Add App" to create a new app.

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. 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!

🥳🥳🥳