Author: [Write your name here]
Collaborator:
Note that this file is written in MarkDown language. A reference is available here: https://www.markdownguide.org/basic-syntax/
Here you can include images, like the logo from SU
This template project will contain a simple interactive web dashboard with Streamlit. Feel free to edit this document as desired
Run the commands below in a terminal to configure the project and install the package dependencies for the first time.
If you are using Mac, you may need to install Xcode. Check the official Streamlit documentation here.
- Create the environment with
python -m venv env
- Activate the virtual environment for Python
- If using Mac or Linux, type the command:
source env/bin/activate
- If using Windows:
- First, set the Default Terminal Profile to CMD Terminal
- Then, type in the CMD terminal:
.\env\Scripts\activate.bat
- If using Mac or Linux, type the command:
- Make sure that your terminal is in the environment (
env
) not in the global Python installation. The terminal should start with the wordenv
- Install required packages
pip install -r ./requirements.txt
- Check that the installation works running
streamlit hello
- Stop the terminal by pressing Ctrl+C
First, make sure that you are running Python from the environment. Check the steps 2 and 3 above. Then, to run the custom dashboard execute the following command:
> streamlit run Dashboard.py
# If the command above fails, use:
> python -m streamlit run Dashboard.py
Tested on Python 3.12.7 with the following packages:
- Jupyter v1.1.1
- Streamlit v1.46.1
- Seaborn v0.13.2
- Plotly v6.2.0
- Scikit-Learn v1.7.0
- shap v0.48.0
Add the project's authors, contact information, and links to websites or portfolios.