Get Started

Set up your Python environment to run the GJD use cases

Prerequisites

Before running any of the examples in this section, make sure you have the following software installed.

1. Python

You need Python 3.10 or higher.

Download from python.org
Verify your installation:

python --version

2. Quarto (for site rendering)

Quarto is used to render the notebooks into the HTML site you are reading. If you only want to run the notebooks locally, you can skip this.

Download from quarto.org

3. IDE (recommended)

IDE	Notes
JupyterLab	Classic notebook experience
VS Code / Cursor	Install the Jupyter extension
Google Colab	Zero install — upload the `.ipynb` file

Required Python Packages

Install all dependencies at once:

pip install requests pandas matplotlib plotly

Or using a requirements.txt (included in the Python/ folder):

pip install -r requirements.txt

Package overview

Package	Purpose
`requests`	HTTP requests to the GJD API
`pandas`	Data manipulation and analysis
`matplotlib`	Static charts and visualizations
`plotly`	Interactive charts

Clone and Render

Once everything is installed, clone the repository and render the Python section:

git clone <repo-url>
cd usecasegjd/Python
quarto render

Run a single notebook

quarto render uc01-forest-cover-caqueta.ipynb

Live preview

quarto preview

Next Steps

Head to API Authentication to configure your API key, then explore the use cases.

---
title: "Get Started"
subtitle: "Set up your Python environment to run the GJD use cases"
---

## Prerequisites

Before running any of the examples in this section, make sure you have the following software installed.

### 1. Python

You need **Python 3.10 or higher**.

- Download from [python.org](https://www.python.org/downloads/)
- Verify your installation:

```bash
python --version
```

### 2. Quarto (for site rendering)

Quarto is used to render the notebooks into the HTML site you are reading. If you only want to run the notebooks locally, you can skip this.

- Download from [quarto.org](https://quarto.org/docs/get-started/)

### 3. IDE (recommended)

| IDE | Notes |
|-----|-------|
| [JupyterLab](https://jupyter.org/) | Classic notebook experience |
| [VS Code](https://code.visualstudio.com/) / [Cursor](https://cursor.sh/) | Install the [Jupyter extension](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter) |
| [Google Colab](https://colab.research.google.com/) | Zero install — upload the `.ipynb` file |

## Required Python Packages

Install all dependencies at once:

```bash
pip install requests pandas matplotlib plotly
```

Or using a `requirements.txt` (included in the `Python/` folder):

```bash
pip install -r requirements.txt
```

### Package overview

| Package | Purpose |
|---------|---------|
| `requests` | HTTP requests to the GJD API |
| `pandas` | Data manipulation and analysis |
| `matplotlib` | Static charts and visualizations |
| `plotly` | Interactive charts |

## Clone and Render

Once everything is installed, clone the repository and render the Python section:

```bash
git clone <repo-url>
cd usecasegjd/Python
quarto render
```

### Run a single notebook

```bash
quarto render uc01-forest-cover-caqueta.ipynb
```

### Live preview

```bash
quarto preview
```

## Next Steps

Head to [API Authentication](api-authentication.qmd) to configure your API key, then explore the use cases.