bmi706-2023-ps3

Hello, Kyla!

Requirements

Please make sure to have the following downloaded and installed on your machine before proceeding.

• Visual Studio Code
• Git
• Anaconda

If you have a preferred text editor and/or know how to manage python virtual environments, please view these requirements as recommendations.

Getting started

Create private GitHub repo from hms-dbmi/bmi706-2023-ps3

In order to work independently of your classmates, we ask that you create a private GitHub repository for this template repo. Select the Download ZIP option to download the archive for this folder.

Unzip the archive and drag the folder into VS Code. Within VS Code, select the Source Control and Publish to GitHub. Modify the name in the prompt at the top of the editor to bmi706-2023-ps3, and select Publish to GitHub Private repository.

This will create a private GitHub repository under <YOUR-GITHUB-USERNAME>/bmi706-2023-ps3. This step is essential for eventually sharing your application on Streamlit Cloud.

Making changes

You can now open your initialized project in VS Code and begin editing.

Selecting a file from the sidebar will open the file in the editor where you are free make changes.

Committing changes

A commit is a snapshot of the state of your repository at a specific time. Git keeps track of history of your repository via commits so that you can revert back to a prior version at any time. In order to synchronize your local changes with the fork on GitHub, you will need to create a new commit adding the changes you've made.

Let's practice making a commit by replacing "Hello, world" with "Hello, <your name>" at the top of this file.

• Open README.md in VS Code.

• Replace world at the top of the file with your name and save the file.

Note how the file tab for README.md is now yellow with an "M", signifing that it has been modified. The Source Control icon in the sidebar additionally has shows a 1, indicating that 1 file has changed.

• Click the Source Control icon in the sidebar and enter Message describing the changes we've made. Click the "Commit" check mark to stage and commit our changes.

• Click the Synchronize Changes to update GitHub with our latest changes

Developing with streamlit

You'll need to set up a Python environment for working your Streamlit application locally. Streamlit's only officially-supported environment manager on Windows, macOS, and linux is Anaconda Navigator. Please make sure you have this installed. (The following is adapted from Streamlit's documentation.)

Create a new Python environment with Streamlit

1.) Follow the steps provided by Anaconda to set up and manage your environment using the Anaconda Navigator.

2.) Select the "▶" icon next to your new environment. Then select "Open terminal":

3.) In the terminal that appears, type:

pip install streamlit

4.) Test that the installation worked:

streamlit hello

Streamlit's Hello app should appear in a new tab in your web browser.

Use your new environment

1.) In Anaconda Navigator, open a terminal in your environment (see step 2 above).

2.) In the terminal that appears, navigate to your local workspace and run:

streamlit run streamlit_app.py

This will open the template streamlit app in the web browser. You can now start editing the contents of streamlit_app.py, and refresh the page in your web browser we see changes.

Advanced setup

You can simplify the workflow using modern Python dependency management tools, specifically the uv tool. The benefit is that it frees you from managing Python versions manually, installing packages globally via pip, and setting up and activating virtual environments.

uv works on a project basis: Dependencies specified in the pyproject.toml file are installed in an isolated (hidden) environment and used whenever you run commands from the project folder with uv run <something>.

1. Install uv
2. clone or download the repository, cd into it
3. initilize the uv project: uv init
4. add dependencies to the project using the requirements.txt file: uv add -r requirements.txt
5. to run the sample Hello application: uv run streamlit hello
6. to run your application: uv run streamlit run streamlit_app.py (attention: there's a second run command, to specify that you're running a .py file)