summer/fall 2026 project kick-off

welcome to the canopy. this is your guide to cloning, setting up, and contributing to the project. we'll walk through everything together — no question is too small.

github.com/kalliannhale/rewildingCities

1. clone the repo (first time only)

git clone <https://github.com/kalliannhale/rewildingCities.git>
cd rewildingCities

if this fails, it's probably a typo. cd means "change directory" — you need to be inside the project folder for everything else to work.

2. set up python

the orchestration layer runs on python. choose whichever method you're comfortable with:

option A: conda/mamba (recommended)

# create environment from our recipe
conda env create -f environment.yml

# activate it
conda activate rewilding

if you use mamba (faster), same thing:

mamba env create -f environment.yml
mamba activate rewilding

option B: pip + venv

python -m venv .venv
source .venv/bin/activate        # mac/linux
pip install -r requirements.txt

verify it works:

python -c "from canopy.orchestrator.orchestrator import Orchestrator; print('canopy loaded')"

every time you open a new terminal to work on the project, you'll need to activate the environment again:

conda activate rewilding     # if using conda/mamba
source .venv/bin/activate    # if using venv