Skip to main content

maxson-build-utils

Centralized org tooling for PyInstaller, DMG, AppImage, DEB, PYZ, etc.

A convention-optional build and deployment framework, with an opinionated Maxson project scaffold available as a convenience.

Spotlight IT

ChatGPT or Gemini can provide good Python core logic. "Fix my problem, tell me the library, write a single script, give me some functions with some arguments."

But how do you run that solution on other computers? For coworkers? For contractors?

maxson-build-utils provides you with an opinionated canvas. Drop in your special core, wire up the args in the functions to the CLI and the GUI, run the builds, and then you've got a one way ticket to the Windows store. IT will probably say yes.

Shadow IT? No, Spotlight IT

Installation

pipx install "maxson-build-utils[pyinstaller]"

Quick Start

Scaffold and edit a new project

mkdir my-project
cd my-project
mbu init all
# edit core.py with special logic
# edit cli.py and gui.py to expose core features
# edit pyproject.toml to add new dependecies

# sync the local new venv
uv sync --group dev --extra gui --extra pyinstaller

Build local artifacts

mbu build shiv
mbu build pyinstaller

Leverage the batteries-included github runners by pushing to github. This will give you files that may be submitted to the Windows Store, the Apple store, and Linux distribution.

git tag v0.1.0
git push origin v0.1.0
# Runnners are designed to build and upload artifacts to the release.
gh release create v0.1.0 --title "my-project v0.1.0"

Helptree

See the maxson-build-utils Typer CLI structure.

maxson-build-utils helptree

SVG of the CLI helptree

Release files for maxson-build-utils 0.1.40

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for maxson-build-utils 0.1.40
File Size Uploaded
maxson_build_utils-0.1.40.tar.gz 447.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for maxson-build-utils 0.1.40
File Interpreter ABI Platform
maxson_build_utils-0.1.40-py3-none-any.whl Python 3 none any Details

Total release size: 922.3 kB

Release files / maxson_build_utils-0.1.40.tar.gz

Download URL maxson_build_utils-0.1.40.tar.gz
Size 447.7 kB
Tags Source
SHA-256 checksum
How to use checksums
c034d1620b8b980dc32ba22b79254f938369aa924622e700c1d224f6b21dcecd
BLAKE2b-256 checksum
How to use checksums
bdafa1b045221e7e9e437ba30c9b264058815983eb8f611d355e5705a440a6ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.

Transparency log

Release files / maxson_build_utils-0.1.40-py3-none-any.whl

Download URL maxson_build_utils-0.1.40-py3-none-any.whl
Size 474.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b515d3af9901a576c261a849fe2e84e36b96394e741f97fc20b8aac5a1aed627
BLAKE2b-256 checksum
How to use checksums
43f93c6dbb97dc0ac41fb851d9c185c5f5bc994c01324d7f51d97ec2e7c57b75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.47

2 release files

0.1.46

2 release files

0.1.45

2 release files

0.1.44

2 release files

0.1.43

2 release files

0.1.42

2 release files

0.1.41

2 release files

This release

0.1.40 This release

2 release files

0.1.39

2 release files

0.1.38

2 release files

0.1.37

2 release files

0.1.36

2 release files

0.1.35

2 release files

0.1.34

2 release files

0.1.33

2 release files

0.1.32

2 release files

0.1.31

2 release files

0.1.30

2 release files

0.1.29

2 release files

0.1.28

2 release files

0.1.27

2 release files

0.1.26

2 release files

0.1.25

2 release files

0.1.24

2 release files

0.1.23

2 release files

0.1.22

2 release files

0.1.21

2 release files

0.1.20

2 release files

0.1.19

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page