install

Additional install commands

macOS

Homebrewverified · 100%

brew install pyinstaller

local Homebrew formula metadata

Linux

Debian aptverified · 92%

sudo apt install pyinstaller

Debian stable package indexes · pyinstaller · source: deb.debian.org

overview

Package summary

Bundle a Python application and all its dependencies

Project links

Commands and aliases

pyi-archive_viewer
pyi-bindepend
pyi-grab_version
pyi-makespec
pyi-set_version
pyinstaller

history

Project history and usage

PyInstaller freezes a Python application, its interpreter, and its dependencies into a distributable one-folder or one-file application bundle.

Project history

PyInstaller descends from Gordon McMillan's original Python Installer, with early development and maintenance credited to William Caban. The modern project retained the freezer model—analyzing imports, collecting Python and native dependencies, and launching them through a platform-specific bootloader—while steadily expanding platform and package compatibility.

Adoption history

PyInstaller became a common answer to distributing Python desktop and command-line applications to users who should not need Python, pip, or the application's modules installed separately. Its maintained hook collection encodes compatibility knowledge for GUI, scientific, and plugin-heavy packages that static import analysis alone cannot fully discover.

How it is used

Run `pyinstaller your_program.py` for a basic build. PyInstaller writes a generated `.spec` file plus `build` and `dist` directories; edit or generate a spec file when the bundle needs data files, hidden imports, runtime options, multiple programs, or platform-specific application metadata. Builds are OS-specific, so artifacts should normally be produced on the target operating system.

Why package nerds care

PyInstaller occupies the application-distribution layer rather than the library-distribution layer: wheels deliver packages into Python environments, while PyInstaller creates OS-specific application bundles carrying an interpreter and dependencies. Its hooks, bootloader, binary inspection utilities, and executable spec files make platform packaging behavior explicit and reproducible.

Timeline

Early lineage: The project was based on Gordon McMillan's Python Installer
2021: The 4.x line added broader contemporary platform and Python support
2022: The 5.x line revised core analysis and bootloader behavior
2023: The 6.x line began a new major release series

Related projects

Gordon McMillan's Python Installer
Nuitka
cx_Freeze
Python wheels

Sources

security posture

Risk level: blue

broad file, network, media, or database tool signal.

Risk classifier

blue risk · medium confidence · tool

Why

broad file, network, media, or database tool signal

Signals

text:archive

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 5 platform targets.
Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: *.spec

executables

Installed executables

Command	Kind	Exposure
`pyi-archive_viewer`	cli	global executable
`pyi-bindepend`	cli	global executable
`pyi-grab_version`	cli	global executable
`pyi-makespec`	cli	global executable
`pyi-set_version`	cli	global executable
`pyinstaller`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-11-04

manager version6.22.3

manager updated2026-10-30

local dataok

upstreamnot checked

latest detectednot detected

https://pyinstaller.org/

infoRelease/tag comparison is only available for GitHub repositories.https://pyinstaller.org/none confidence

install metadata

Package metadata

Package key	brew:pyinstaller
Version	6.22.3
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/pyinstaller
Homepage	https://pyinstaller.org/
Repository	https://github.com/pyinstaller/pyinstaller
Upstream docs	https://pyinstaller.org/
License	GPL-2.0-or-later
Source archive	https://files.pythonhosted.org/packages/63/41/f90302845945abd4ed647933ff5ee7c6ac93983187be67f897b6cb613331/pyinstaller-6.22.3.tar.gz
Last updated	2026-10-30T12:25:08+02:00
Pulse	updated
Dependencies	python@3.15
Bottle	available (on arm64_golden_gate, arm64_linux, arm64_sequoia, arm64_tahoe, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	pyinstaller
Version Scheme	0
Revision	1
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

pyinstaller 6.13.0+ds-2

Utility to bundle a Python application into a single package

https://pyinstaller.org/en/stable/

sudo apt install pyinstaller

Section: utils
Architecture: amd64
2 dependencies
normalized package name match
Matched by: Pyinstaller

Debian stable package indexes · deb.debian.org · Debian stable package indexes: pyinstaller from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

Debian apt95%

python3-pyinstaller 6.13.0+ds-2

Python modules to bundle a Python application into a single package

https://pyinstaller.org/en/stable/

sudo apt install python3-pyinstaller

Section: python
Architecture: amd64
Source Package: pyinstaller
10 dependencies
normalized package name match
Matched by: Pyinstaller

Debian stable package indexes · deb.debian.org · Debian stable package indexes: python3-pyinstaller from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/pyinstaller.yml

Used sources

Geiger risk classifier
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment
pkg.so package database
pkgdb category and tag curation

Install pyinstaller with Homebrew, apt