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.4.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.4.0
File	Size	Uploaded
pyenv_native-0.4.0.tar.gz	12.7 kB	Aug 18, 2026	Details

Built distribution (wheel)

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

Total release size: 26.0 kB

Release files / pyenv_native-0.4.0.tar.gz

Download URL	pyenv_native-0.4.0.tar.gz
Size	12.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`c63463d5639c185445c96bef8f31cf19cf4edff1953f8631a94e7566572aeef1`
BLAKE2b-256 checksum How to use checksums	`d78612b55a8a127d11b989ad177339a563c3e2c22d04beee6fc913c15f1c872d`
Upload date	Aug 18, 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/96526434af5e53606d5e6b7a75c2affebc1d8c83

Workflow

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

Artifact

Subject: pyenv_native-0.4.0.tar.gz
SHA-256 checksum: c63463d5639c185445c96bef8f31cf19cf4edff1953f8631a94e7566572aeef1 Verifying attestations

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

Download URL	pyenv_native-0.4.0-py3-none-any.whl
Size	13.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`868147f0064276e8b8c04640960fc79c6c46c6b46b6fd0fc27ef8ad05d740f6e`
BLAKE2b-256 checksum How to use checksums	`9c4f5ed70975294d57f39d816dce47c4fea837e9e4859589d36b54c86a3bb0d8`
Upload date	Aug 18, 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/96526434af5e53606d5e6b7a75c2affebc1d8c83

Workflow

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

Artifact

Subject: pyenv_native-0.4.0-py3-none-any.whl
SHA-256 checksum: 868147f0064276e8b8c04640960fc79c6c46c6b46b6fd0fc27ef8ad05d740f6e Verifying attestations