CURE Ground Station

CU Rocketry Ground Station software for communicating with MARTHA flight computers.

What You Need

• A laptop with terminal access
• Python 3.9+ installed
• uv installed (instructions below)

If you are new to Python tooling: uv replaces most day-to-day pip and virtual environment setup steps.

Install uv (One Time Per Laptop)

Choose your OS:

macOS and Linux

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

Windows PowerShell

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

After install, open a new terminal and verify:

uv --version

First-Time Project Setup

From your terminal:

git clone https://github.com/CURocketEngineering/Ground-Station.git
cd Ground-Station
uv sync --dev

What this does:

• Creates a local virtual environment in .venv
• Installs all runtime dependencies
• Installs developer tools (like ruff, pre-commit)
• Uses the lockfile to keep installs consistent across the team

Run Commands (No Manual Activation Needed)

Use uv run so you can run commands directly from the repo root:

uv run cure-ground --help
uv run cure-ground gui
uv run cure-ground post-flight

GUI Setup

Before launching the GUI, download the shared GUI assets and place them in:

• Linux/macOS: cure_ground/gui/resources
• Windows (same path from repo root): cure_ground\gui\resources

Assets folder: Ground-Station-Assets (SharePoint)

Then launch:

uv run cure-ground gui

Optional: Activate The Environment

Most users should keep using uv run ..., but if you want direct command access:

• Linux/macOS: source .venv/bin/activate
• Windows PowerShell: .\.venv\Scripts\Activate.ps1
• Windows CMD: .\.venv\Scripts\activate.bat

Then you can run:

cure-ground --help

Development

Useful commands:

uv run ruff check .
uv run pre-commit run --all-files