Tools Installation​‌​‌​‌​​‍​‌​​​‌​‌‍​​‌‌‌​‌​‍​​‌‌​‌​​‍​‌‌​​‌​‌‍​​‌‌‌​​​‍​‌‌​​‌​​‍​​‌‌‌​​‌‍​‌‌​​​‌​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​​‌‌​‌​‌‍​‌‌​​‌‌​‍​​‌‌​‌‌​‍​‌‌​​‌​‌‍​​‌‌​‌‌‌‍​‌‌​​​‌‌‍​​‌‌​​‌‌‍​‌‌​​‌​​‍​​‌‌‌​‌​‍​​‌‌​​‌​‍​​‌‌​​​​‍​​‌‌​​‌​‍​​‌‌​‌‌​‍​​‌‌​​​​‍​​‌‌​​‌​‍​​‌‌​​​‌‍​​‌‌​​‌‌‍​​‌‌‌​‌​‍​​‌‌‌​​​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​​‌‌​‌​​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​‌‌​​‌​‌‍​​‌‌‌​​​¶

This guide will walk you through the installation of all the tools needed for the course, step by step.​‌​‌​‌​​‍​‌​​​‌​‌‍​​‌‌‌​‌​‍​​‌‌​‌​​‍​‌‌​​‌​‌‍​​‌‌‌​​​‍​‌‌​​‌​​‍​​‌‌‌​​‌‍​‌‌​​​‌​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​​‌‌​‌​‌‍​‌‌​​‌‌​‍​​‌‌​‌‌​‍​‌‌​​‌​‌‍​​‌‌​‌‌‌‍​‌‌​​​‌‌‍​​‌‌​​‌‌‍​‌‌​​‌​​‍​​‌‌‌​‌​‍​​‌‌​​‌​‍​​‌‌​​​​‍​​‌‌​​‌​‍​​‌‌​‌‌​‍​​‌‌​​​​‍​​‌‌​​‌​‍​​‌‌​​​‌‍​​‌‌​​‌‌‍​​‌‌‌​‌​‍​​‌‌‌​​​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​​‌‌​‌​​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​‌‌​​‌​‌‍​​‌‌‌​​​

System Requirements¶

Step 1: Install Git¶

Git is the version control system we will use to manage our code.

# Open PowerShell or CMD as Administrator
winget install Git.Git

git --version
# Should show: git version 2.x.x

# If you don't have Homebrew, install it first:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Git
brew install git

xcode-select --install

git --version
# Should show: git version 2.x.x

sudo apt-get update
sudo apt-get install git

sudo dnf install git

sudo pacman -S git

git --version
# Should show: git version 2.x.x

Step 2: Configure Git¶

Once Git is installed, we need to configure it with your information:

# Set your name (use your real name)
git config --global user.name "Your Full Name"

# Set your email (use the same email as GitHub)
git config --global user.email "your@email.com"

# Verify configuration
git config --list

Step 3: Create a GitHub Account¶

GitHub is the platform where we will host our code.

1. Go to github.com
2. Click on "Sign Up"
3. Fill in the form:
   • Username: Choose a professional name (e.g.: juan-garcia, not kitty123)
   • Email: Use the same one you configured in Git
   • Password: Use a strong password
4. Verify your email
5. Complete your profile (photo, bio optional)

Step 4: Install Python¶

We need Python 3.11 or higher.

winget install Python.Python.3.11

python --version
# Should show: Python 3.11.x

pip --version
# Should show: pip 23.x.x

brew install python@3.11

python3 --version
# Should show: Python 3.11.x

pip3 --version
# Should show: pip 23.x.x

sudo apt-get update
sudo apt-get install python3.11 python3-pip

sudo dnf install python3.11 python3-pip

python3 --version
# Should show: Python 3.11.x

pip3 --version
# Should show: pip 23.x.x

Step 5: Install PyCharm (Optional but Recommended)¶

PyCharm is the IDE we recommend for the course.

PyCharm Community Edition (Free)¶

brew install --cask pycharm-ce

sudo snap install pycharm-community --classic

Alternatives to PyCharm¶

If you prefer another editor:

• Visual Studio Code: Lightweight and extensible (code.visualstudio.com)
• Jupyter Lab: For working with notebooks (jupyter.org)
• Sublime Text: Advanced text editor (sublimetext.com)

Step 6: Clone the Repository¶

Now that you have everything installed, clone your fork of the repository:

# Navigate to the folder where you want to save the project
cd Documents  # or whichever folder you prefer

# Clone YOUR fork (replace YOUR_USERNAME)
git clone https://github.com/YOUR_USERNAME/ejercicios-bigdata.git

# Enter the folder
cd ejercicios-bigdata

# Connect to the original repository (upstream)
git remote add upstream https://github.com/TodoEconometria/ejercicios-bigdata.git

# Verify that everything is set up correctly
git remote -v

You should see something like this:

origin    https://github.com/YOUR_USERNAME/ejercicios-bigdata.git (fetch)
origin    https://github.com/YOUR_USERNAME/ejercicios-bigdata.git (push)
upstream  https://github.com/TodoEconometria/ejercicios-bigdata.git (fetch)
upstream  https://github.com/TodoEconometria/ejercicios-bigdata.git (push)

Step 7: Create a Virtual Environment¶

It is a good practice to use virtual environments for each project:

# Make sure you are in the project folder
cd ejercicios-bigdata

# Create virtual environment
python -m venv .venv

# Activate virtual environment
# Windows:
.venv\Scripts\activate

# macOS/Linux:
source .venv/bin/activate

# You should see (.venv) at the beginning of your terminal

Step 8: Install Dependencies¶

With the virtual environment activated, install the project dependencies:

# Upgrade pip
pip install --upgrade pip

# Install project dependencies
pip install -r requirements.txt

# Verify that everything was installed correctly
python -c "import pandas, dask, sqlite3; print('All OK!')"

If you see "All OK!", you are ready to get started.

Final Verification¶

Run these commands to verify that everything is installed correctly:

# Git
git --version

# Python
python --version

# Pip
pip --version

# Verify libraries
python -c "import pandas; print(f'Pandas {pandas.__version__}')"
python -c "import dask; print(f'Dask {dask.__version__}')"

Common Issues¶

python -m venv .venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate      # Windows
pip install -r requirements.txt

# Navigate to the correct folder
cd path/to/ejercicios-bigdata

# Verify you are in the correct folder
ls -la  # You should see a .git/ folder

​‌​‌​‌​​‍​‌​​​‌​‌‍​​‌‌‌​‌​‍​​‌‌​‌​​‍​‌‌​​‌​‌‍​​‌‌‌​​​‍​‌‌​​‌​​‍​​‌‌‌​​‌‍​‌‌​​​‌​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​​‌‌​‌​‌‍​‌‌​​‌‌​‍​​‌‌​‌‌​‍​‌‌​​‌​‌‍​​‌‌​‌‌‌‍​‌‌​​​‌‌‍​​‌‌​​‌‌‍​‌‌​​‌​​‍​​‌‌‌​‌​‍​​‌‌​​‌​‍​​‌‌​​​​‍​​‌‌​​‌​‍​​‌‌​‌‌​‍​​‌‌​​​​‍​​‌‌​​‌​‍​​‌‌​​​‌‍​​‌‌​​‌‌‍​​‌‌‌​‌​‍​​‌‌‌​​​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​​‌‌​‌​​‍​​‌‌​​​‌‍​‌‌​​​​‌‍​‌‌​​‌​‌‍​​‌‌‌​​​---

Next Steps¶

Now that you have everything installed, continue with:

• Your First Exercise - Learn the basic workflow
• Fork and Clone - Understand how to work with Git and GitHub
• Course Roadmap - See all available exercises