Data Analysis Project

My Credential

With submission rate:

About

This repository contains a data analysis project analyzing public e-commerce data and a Streamlit dashboard.

View my notebook on Colab.
View my deployed dashboard on Streamlit.
Dashboard screencast overview.

Table of Contents

• Project Structure
• Prerequisites
• Setup Instructions
  • Clone the Repository
  • Python Environment Setup
  • Virtual Environment Setup
  • Install Dependencies
  • Running the Dashboard
• Troubleshooting
  • Common Issues and Solutions

Project Structure

.
├── dashboard
│   ├── dashboard.py
│   ├── pngwing.com.png
├── e-commerce_public_dataset
│   ├── *.csv
├── notebook.ipynb
├── README.md
├── requirements.txt
├── script.py
├── url.txt

Prerequisites

• Git
• pyenv
• Python3

Setup Instructions

Clone the Repository

Clone this repository to local machine.

git clone https://github.com/fxrdhan/Data-Analysis-Project.git
cd Data-Analytics-Project

Python Environment Setup

Install pyenv (if not already installed)

Linux:

curl https://pyenv.run | bash

Windows: Here

macOS: Here

Set up shell environment for Pyenv

Here

Install Python3 version (Python 3.12.7 is recommended)

Here

Virtual Environment Setup

Create virtual environment

• macOS/Linux:

  pyenv virtualenv 3.x.x myenv

• Windows (PowerShell):

  pyenv-win virtualenv 3.x.x myenv

Activate virtual environment

• macOS/Linux:

  pyenv activate myenv

• Windows (PowerShell):

  pyenv shell myenv

To deactivate when you're done

• macOS/Linux:

  pyenv deactivate

• Windows (PowerShell):

  pyenv shell system

Install Dependencies

Install required packages:

pip install -r requirements.txt

Running the Dashboard

cd dashboard
streamlit run dashboard.py

Troubleshooting

Common Issues and Solutions

1. pyenv: command not found

   • Ensure pyenv is properly installed
   • Check if pyenv is added to your PATH
   • Restart your terminal

2. Package installation errors

   • Upgrade pip: pip install --upgrade pip
   • Try installing packages individually

3. Streamlit port already in use

   • Kill the process using the port: lsof -i:8501
   • Try running on a different port: streamlit run dashboard.py --server.port XXXX