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

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.39

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.39
File Size Uploaded
maxson_build_utils-0.1.39.tar.gz 447.5 kB Details

Built distribution (wheel)

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

Total release size: 921.6 kB

Release files / maxson_build_utils-0.1.39.tar.gz

Download URL maxson_build_utils-0.1.39.tar.gz
Size 447.5 kB
Tags Source
SHA-256 checksum
How to use checksums
352fbfda9262bb74d0e664a47e4366b52ff8425afbd775ed3423467c8e87d150
BLAKE2b-256 checksum
How to use checksums
165b28403a01b9e6d4d9e7e3da299d726af1fcaa0f923dbedce3e8a1ecfc9f6d
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.39-py3-none-any.whl

Download URL maxson_build_utils-0.1.39-py3-none-any.whl
Size 474.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2c4a5cb7f4aeb04bbe26b6c46f1d93ccec9e78068ab5c306dbe23f4ac259d9a9
BLAKE2b-256 checksum
How to use checksums
6d9eab6aef0c72d4aa3effd99a34071b22d4de7f784d75ad9f3ebbef37a158db
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

0.1.40

2 release files

This release

0.1.39 This release

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