astr400

Environment setup

Steps through Git are on your computer. The SFSU virtual machine and Git on that machine are the remote host where MESA runs. Docker is optional and only demonstrates a container workflow. Pick a topic below, or skip anything you already have. Day-to-day commands live on the Use index.

  1. 01

    Toolchain (optional)

    Install compilers if you will build scientific packages with native extensions.

    Toolchain setup
  2. 02

    Python environment

    Create a dedicated Python 3.12 environment. Conda is the default path; uv is a faster alternative.

    Miniconda / Anaconda uv workflow
  3. 03

    Editor and Jupyter

    Use notebooks for exploration and VS Code for scripts and larger projects.

    Jupyter and VS Code
  4. 04

    Git

    Install Git, set your identity, and connect to GitHub.

    Git and GitHub setup
  5. 05

    SFSU virtual machine

    On jmbrewer, the remote host where MESA runs. VPN, SSH, and the shared install.

    Connect to the VM uv on the server (optional)
  6. 06

    Git on the SFSU VM

    On jmbrewer, set your name, email, and a GitHub key that stays on that machine.

    Configure Git on the VM
  7. 07

    Docker (optional)

    Optional demo of a container workflow. Not required on your computer or on the SFSU VM.

    Choose your operating system Docker Desktop on macOS Docker Engine on Ubuntu Docker Desktop on Windows (WSL)