Packer

A Python automation tool that streamlines Python release workflows: creating optimized archives, uploading releases to GoFile, updating Git repositories, and publishing GitHub releases with AI-generated notes.

Contents

• Installation
• Binary Downloads
• Usage
• Demos
• Configuration
  • Settings
  • Config
  • Extra customization
• Extra notes
• Warning
• Features
• Feedback and Suggestions
• Honorable mentions
• Changelog
• In future updates

Installation

Available via:

• GitHub Releases: GitHub Releases
• Third-party website (GoFile): Archive

You can also install from source in a virtual environment:

python -m venv .venv
source .venv/bin/activate
pip install .

Binary Downloads

When downloading, please choose the correct build for your operating system:

To install:

• GitHub: Download the appropriate binary or archive for your system from the Releases page.
• Third-party website (GoFile): Head to the website Archive and download the specific archive for the desired version.

After installing, continue following instructions in this README.

Usage

After installing the project, you can run it from the command line using the package entry points.

Basic example

python -m packer.main

If the package is installed in your environment, you can also run:

packer

Demos

• TUI release Demo - Watch on youtube
• CLI setup demo - Watch on youtube
• CLI change demo - Watch on youtube

Configuration

Settings

See docs/SETTINGS.md for global Packer settings and docs/PROJECT.md for project-specific settings. For CLI options, see docs/CLI.md.

Config

Packer expects a project layout with src/ code and an assets/ folder containing at least version.json and integrity.json. A CHANGELOG.md at the project root is required for release-note generation.

Extra customization

See docs/PROJECT.md for notes about adding custom assets and creating profiles.

Extra notes

• Packer integrates with GoFile for archive hosting and GitHub for release publishing.
• Optional compilation via Nuitka is supported for producing compiled releases.

Warning

• Possible problems might arise in that case, please back up your project before running for the first time and even if packer messed up, it won't destroy or corrupt your project so GL fixing it! Here is also a guide for manually reverting a release in case it fails catastrophically: docs/MANUAL_REVERT.md.
• Note that automatic error reporting is enabled by default. You can disable it in the settings

Features

• Archive Creation: Packages your program with customizable exclusion rules.
• Cloud Upload: Uploads archives to GoFile with optional folder management.
• Git Integration: Handles repository updates and tagging.
• GitHub Releases: Publishes releases with AI-generated titles and descriptions.
• Optional Compilation: Supports Nuitka for compiled distributions.
• Error Handling: Automatic rollback to previous version if a step fails.
• AI-Powered: Uses Ollama (when available) to generate release notes.

Feedback and Suggestions

Please open issues or pull requests on the project's GitHub repository, or email [emilspro888@gmail.com] to suggest improvements or report bugs.

Honorable mentions

• Ollama — used for AI-generated release notes (optional).
• GoFile — used as archive hosting provider.

Changelog

See the full history in CHANGELOG.md.

In future updates

See planned features and roadmap in docs/ROADMAP.md.