Radio Telemetry Map - Environment Setup

Quick Setup Options

Option 1: Conda Environment (Recommended)

cd server
conda env create -f environment.yml
conda activate radio-telemetry
python app.py

Option 2: Python Virtual Environment

cd server
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python app.py

Option 3: Automatic Setup Script

cd server
chmod +x setup.sh
./setup.sh

Environment Files Included

For Conda Users: environment.yml

• Creates a complete conda environment
• Includes Python 3.9 and all dependencies
• Most reliable for cross-platform compatibility

For pip Users: requirements.txt

• Traditional pip requirements file
• Works with virtual environments
• Lighter weight option

Universal: setup.sh

• Automatically detects your setup (conda vs pip)
• Creates appropriate environment
• Installs all dependencies

Which Option Should You Choose?

Use Conda if:

• You have Anaconda/Miniconda installed
• You work with data science packages
• You want the most reliable cross-platform setup
• You prefer isolated environments with specific Python versions

Use pip + venv if:

• You prefer lightweight setups
• You're already familiar with Python virtual environments
• You don't have conda installed

Use the setup script if:

• You want a one-command setup
• You're not sure what's installed on your system
• You're sharing this with others who might have different setups

Commands Summary

Create environment:

# Conda
conda env create -f environment.yml

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

Activate environment:

# Conda
conda activate radio-telemetry

# venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

Deactivate environment:

# Both conda and venv
deactivate

Update environment:

# Conda
conda env update -f environment.yml

# pip
pip install -r requirements.txt --upgrade

For Sharing Your Project

Include all three files in your repository:

• environment.yml - For conda users
• requirements.txt - For pip users
• setup.sh - For automatic setup

This way, anyone can use their preferred package manager!