pyenv-native

PyPI Channel Runtime License

pyenv-native on PyPI is the Python convenience package for installing the native pyenv-native release bundles.

Those bundles install both:

pyenv
pyenv-mcp

It exists for users who:

already have Python installed,
want a pip or pipx entrypoint,
still want the real runtime to remain native.

Important principle

This package installs pyenv-native. It does not replace pyenv-native with a Python implementation.

Release selection behavior

By default, the package targets the latest published GitHub release.

What it does

downloads native release bundles,
verifies checksums,
reads bundle metadata,
extracts the bundle,
runs the bundled installer,
installs the companion pyenv-mcp server when the bundle provides it,
supports GitHub Release-based installs,
works with Windows ZIP bundles and Linux/macOS .tar.gz bundles.

Quick start

`pipx` latest release

pipx install pyenv-native
pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv

`pip` latest release

python -m pip install pyenv-native
pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv

POSIX latest release

python -m pip install pyenv-native
pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~/.pyenv

Commands

pyenv-native verify <bundle-archive> [--checksum-path <bundle.sha256>]
pyenv-native download [--bundle-url <url> | --release-base-url <url> | --github-repo <owner/repo>] [--tag <tag>]
pyenv-native install [--bundle-path <bundle-archive> | --release-base-url <url> | --github-repo <owner/repo>] [--tag <tag>] [--install-root <dir>]

Examples

Verify a local bundle:

pyenv-native verify .\dist\pyenv-native-windows-x64.zip --checksum-path .\dist\pyenv-native-windows-x64.zip.sha256

Install from a local bundle:

pyenv-native install --bundle-path .\dist\pyenv-native-windows-x64.zip --checksum-path .\dist\pyenv-native-windows-x64.zip.sha256 --install-root ~\.pyenv

Install from the latest GitHub release:

pyenv-native install --github-repo imyourboyroy/pyenv-native --install-root ~\.pyenv

Install a POSIX bundle:

pyenv-native install --bundle-path ./dist/pyenv-native-linux-x64.tar.gz --checksum-path ./dist/pyenv-native-linux-x64.tar.gz.sha256 --install-root ~/.pyenv --shell bash

Relationship to the main project

For the full project overview, install scripts, release-bundle flow, and command reference, see the main repository README:

https://github.com/imyourboyroy/pyenv-native

Metadata

Release files for pyenv-native 0.5.0

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

Source distribution (sdist)

Source distribution for pyenv-native 0.5.0
File	Size	Uploaded
pyenv_native-0.5.0.tar.gz	12.8 kB	Oct 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pyenv-native 0.5.0
File	Interpreter	ABI	Platform	Reset
pyenv_native-0.5.0-py3-none-any.whl 13.3 kB Oct 12, 2026	Python 3	none	any	Details

Total release size: 26.1 kB

Release files / pyenv_native-0.5.0.tar.gz

Download URL	pyenv_native-0.5.0.tar.gz
Size	12.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`4ac62b703b4a3c92e7fa3ac0c303393df905ba79a5f49c2eb9fdd2d3ab3a7692`
BLAKE2b-256 checksum How to use checksums	`ac9f41ac842ca8df17bfc4e8e65a74d832a944701efdcabd1ee1343c09dfc84c`
Upload date	Oct 12, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ImYourBoyRoy/pyenv-native
Publishing commit: github.com/ImYourBoyRoy/pyenv-native/tree/f8ee870be73fd8d7d3a4fbd24e8750ccba32ed78

Workflow

Publishing configuration: github.com/ImYourBoyRoy/pyenv-native/blob/f8ee870be73fd8d7d3a4fbd24e8750ccba32ed78/.github/workflows/release.yml
Publishing logs: github.com/ImYourBoyRoy/pyenv-native/actions/runs/38307350512/attempts/1

Artifact

Subject: pyenv_native-0.5.0.tar.gz
SHA-256 checksum: 4ac62b703b4a3c92e7fa3ac0c303393df905ba79a5f49c2eb9fdd2d3ab3a7692 Verifying attestations

Release files / pyenv_native-0.5.0-py3-none-any.whl

Download URL	pyenv_native-0.5.0-py3-none-any.whl
Size	13.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a0b7f3b62a687eed50e0dfc3c284a0017203ea7f0334ac5886717f4ad9499c52`
BLAKE2b-256 checksum How to use checksums	`f6c1fe2ce6469cd5abd27e15d2633f65a58e6c691fa1e2bff9d850e8cab5079b`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ImYourBoyRoy/pyenv-native
Publishing commit: github.com/ImYourBoyRoy/pyenv-native/tree/f8ee870be73fd8d7d3a4fbd24e8750ccba32ed78

Workflow

Publishing configuration: github.com/ImYourBoyRoy/pyenv-native/blob/f8ee870be73fd8d7d3a4fbd24e8750ccba32ed78/.github/workflows/release.yml
Publishing logs: github.com/ImYourBoyRoy/pyenv-native/actions/runs/38307350512/attempts/1

Artifact

Subject: pyenv_native-0.5.0-py3-none-any.whl
SHA-256 checksum: a0b7f3b62a687eed50e0dfc3c284a0017203ea7f0334ac5886717f4ad9499c52 Verifying attestations