pygta-workspace-template

This repository is a GitHub template for creating a pyglotaran analysis and development workspace in VS Code. A generated repository is not a single Python package. It combines analysis projects, local helper code, and editable checkouts of upstream pyglotaran repositories in one place.

Use this template if you want to:

• keep notebooks, model YAML files, data, and results together per experiment
• add shared workspace-specific helpers in pygta-local-extras
• develop or test changes against local clones of pyglotaran and pyglotaran-extras
• bootstrap the full environment with one command and keep it aligned to configured branches

If you only want to install and use pyglotaran as a library, you probably do not need this workspace template.

Use This Template

• Create a new repository from this template.
• Clone your new repository locally.
• Run uv run bootstrap.py to clone the editable upstream dependencies and initialize the

environment.

• On first bootstrap, the root project name is normalized automatically by removing the trailing -template. Interactive runs show a menu with four choices: pygta-workspace, the repository folder name, [github-username]-workspace, or a custom name.

Prerequisites

• git (git for windows)
• uv (install)
• Python 3.10+

Bootstrap Workspace

Run from the repository root:

To use a fork or non-default branch, edit repos.toml and re-run uv run bootstrap.py --update.