Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Gurneet1928/TryMLEasy/llms.txt

Use this file to discover all available pages before exploring further.

Running TryMLEasy locally requires Python 3.8 or newer and pip. The entire setup takes only a few minutes — you clone one repository, install the dependencies listed in requirements.txt, and launch the Streamlit development server. No database, no environment variables, and no build step are needed.

Prerequisites

Before you begin, confirm the following tools are available in your terminal.
ToolMinimum VersionPurpose
Python3.8Runtime for all application code
pipLatest stableInstalls Python packages
gitAny recent versionClones the repository
Verify your versions by running:
python --version
pip --version
TensorFlow requires Python 3.8–3.11. Python 3.12 and above are not supported by TensorFlow at this time. Additionally, the initial TensorFlow download can take several minutes depending on your internet connection and machine architecture — this is expected behaviour.

Install Steps

1

Clone the repository

git clone https://github.com/Gurneet1928/TryMLEasy.git && cd TryMLEasy
This downloads the full project — source pages, sample data, images, and requirements.txt — into a new TryMLEasy directory and moves you into it.
2

Create a virtual environment (optional but recommended)

A virtual environment keeps TryMLEasy’s dependencies isolated from your system Python installation.
python -m venv venv
Then activate it:
source venv/bin/activate
Your terminal prompt will change to show (venv) when the environment is active.
3

Install all dependencies

pip install -r requirements.txt
This installs all 15 packages listed in requirements.txt. Allow a few minutes for TensorFlow to download and install.
4

Launch the app

streamlit run home_page.py
Streamlit will compile the app and open it automatically in your default browser. If it doesn’t open automatically, navigate to http://localhost:8501.

Dependencies

The following packages are declared in requirements.txt and are installed automatically by pip install -r requirements.txt.
PackagePurpose
extra_streamlit_componentsAdvanced Streamlit UI components including step-progress indicators
kerasHigh-level neural network API (used as the TensorFlow front-end)
matplotlibStatic plots and neural network architecture diagrams
mpld3Converts Matplotlib figures to interactive D3.js-powered charts
numpyNumerical computing foundation used across all ML operations
pandasDataset loading, manipulation, and tabular display in the app
PillowImage loading and processing (used for diagrams and UI assets)
plotlyInteractive charts including the predicted-vs-true scatter plot
scikit_learnAll traditional ML models, scalers, and decomposition methods
seabornStatistical data visualization, including the correlation heatmap
st_pagesMulti-page Streamlit navigation and page visibility management
streamlitCore web app framework and interactive frontend
streamlit_extrasExtra utilities including the switch_page navigation helper
streamlit_plotly_eventsCaptures user interaction events on Plotly charts within Streamlit
tensorflowDeep learning framework powering the neural network builder and training

Running the App

Once dependencies are installed, you can start the app with either of these equivalent commands:
python -m streamlit run home_page.py
or
streamlit run home_page.py
Both commands launch the same Streamlit development server. The app is available at:
http://localhost:8501
by default. If port 8501 is already in use on your machine, Streamlit will automatically try 8502, 8503, and so on — it will print the actual URL in your terminal output.

Deploying to Streamlit Cloud

TryMLEasy can be deployed for free on Streamlit Cloud so you (or others) can access it from any browser without a local install.
  1. Fork the TryMLEasy repository to your own GitHub account.
  2. Sign in at https://streamlit.io/cloud with your GitHub account.
  3. Click New app, select your forked repository, set the main file path to home_page.py, and click Deploy.
Streamlit Cloud reads requirements.txt automatically and handles the full installation. Your public app URL will be active within a few minutes. The official deployment lives at https://trymleasy-2-0.streamlit.app/.

Build docs developers (and LLMs) love