IntroDataScience

Setup Guide

Complete environment setup for the Intro to Data Science course.

1. Installing VS Code

VS Code is a free, powerful code editor that works on all operating systems.

Download VS Code:

Verify Installation:

  1. Open VS Code
  2. You should see a welcome screen
  3. Close any welcome tabs

2. Installing UV Package Manager

UV is a fast Python package manager that makes dependency management simple.

macOS/Linux

Open Terminal and run:

curl -LsSf https://astral.sh/uv/install.sh | sh

Verify installation:

uv --version

You should see something like: uv 0.5.0 or higher

Windows

Open PowerShell and run:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Verify installation:

uv --version

Troubleshooting UV Installation

If uv --version doesn’t work:

3. Cloning the Repository

If you don’t have Git installed:

Clone the repository:

git clone https://github.com/quickskilling/IntroDataScience.git
cd IntroDataScience

Option B: Download ZIP

  1. Go to the GitHub repository
  2. Click the green “Code” button
  3. Select “Download ZIP”
  4. Extract the ZIP file
  5. Open Terminal/PowerShell and navigate to the extracted folder:
cd path/to/IntroDataScience

4. Creating the Project Environment with UV

UV will automatically create a virtual environment and manage Python for you.

Navigate to the project directory (if you haven’t already):

cd IntroDataScience

Check that you’re in the right place:

ls

You should see files like pyproject.toml, README.md, etc.

5. Installing Dependencies

Run this single command to install all course dependencies:

uv sync

What’s happening:

Expected output:

Resolved 29 packages in 401ms
Prepared 4 packages in 4.75s
Installed 26 packages in 191ms
 + marimo==0.18.3
 + polars==1.36.0
 + plotly==6.5.0
 ...

This might take 1-2 minutes on first run.

6. Verifying Installation

Let’s make sure everything works!

Check Python version:

uv run python --version

You should see: Python 3.12.x or higher

Check installed packages:

uv run python -c "import marimo, polars, plotly; print('✓ All packages imported successfully!')"

You should see: ✓ All packages imported successfully!

7. Launching Your First Marimo Notebook

Time to see Marimo in action!

Start the Python basics notebook:

uv run marimo edit example_notebooks/01_python_basics.py

What happens:

  1. A browser window opens automatically
  2. You see the Marimo notebook interface
  3. The notebook is ready to use!

Expected output in terminal:

marimo server is running at http://localhost:2718

Try it:

To stop the notebook:

8. VS Code Extensions to Install

Enhance your coding experience with these extensions.

Essential Extensions

  1. Python Extension

    • Open VS Code
    • Click the Extensions icon (or press Ctrl/Cmd + Shift + X)
    • Search for “Python”
    • Install the one by Microsoft

  2. Marimo Extension (Optional but recommended)

    • Search for “Marimo”
    • Install to get syntax highlighting for Marimo notebooks

  3. GitHub Copilot (Optional)

    • Search for “GitHub Copilot”
    • Requires GitHub account
    • Free for students and verified teachers
    • See copilot-assisted-coding.md for setup

9. Troubleshooting Common Issues

Issue: “uv: command not found”

Solution:

Issue: “Python version too old”

UV will automatically install Python 3.12+, but if you see this error:

Solution:

uv python install 3.12

Issue: “Failed to resolve packages”

Solution:

  1. Check your internet connection
  2. Try again: uv sync
  3. Clear cache: uv cache clean then uv sync

Issue: Marimo notebook won’t open in browser

Solution:

  1. Check the terminal output for the URL (usually http://localhost:2718)
  2. Manually open that URL in your browser
  3. Try a different port: uv run marimo edit --port 8080 example_notebooks/01_python_basics.py

Issue: Import errors in notebooks

Solution:

Issue: “Permission denied” on macOS/Linux

Solution:

Issue: Windows antivirus blocking installation

Solution:

Quick Command Reference

Once you’re set up, here are the commands you’ll use most:

# Start a notebook
uv run marimo edit example_notebooks/01_python_basics.py

# Run a Python script
uv run python script.py

# Install a new package
uv add package-name

# Update all dependencies
uv sync

# Check what's installed
uv pip list

Next Steps

You’re all set! Here’s what to do next:

  1. Start learning: Open example_notebooks/01_python_basics.py
  2. Read the main README: Go back to README.md for the learning path
  3. Explore the tools: Check out other docs:

Getting Help

Stuck?

Remember: Everyone gets stuck sometimes. That’s part of learning! Keep trying, read error messages, and ask for help when needed.

Happy Coding! 🎉