Skip to content

Publishing

GroundGuard is prepared for PyPI Trusted Publishing.

Local Build Check

python -m pip install -e ".[dev]"
python -m build
twine check dist/*

GitHub Trusted Publishing

The repository includes .github/workflows/publish.yml. To complete PyPI publishing:

  1. In the PyPI account chasen2041, open account-level Publishing.
  2. Add a pending GitHub trusted publisher:
  3. PyPI project: groundguard-ai
  4. Owner: chasen2041maker
  5. Repository name: GroundGuard
  6. Workflow name: publish.yml
  7. Environment name: leave blank for the current release workflow
  8. Publish a GitHub Release for the matching version tag.
  9. The workflow builds and publishes the package without storing a PyPI token.

groundguard-ai is the PyPI distribution name. The Python import package remains groundguard.

If the workflow fails with invalid-publisher, the PyPI trusted publisher does not match the claims in the GitHub Actions token yet. Fix the PyPI publisher configuration, then re-run the failed Publish Python Package workflow.