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

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.2.38
File	Size	Uploaded
pyenv_native-0.2.38.tar.gz	12.6 kB	Aug 13, 2026	Details

Built distribution (wheel)

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

Total release size: 25.9 kB

Release files / pyenv_native-0.2.38.tar.gz

Download URL	pyenv_native-0.2.38.tar.gz
Size	12.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`e77950a26a9bf549ad761d4634a81b998d590e66218c5804435257b768472020`
BLAKE2b-256 checksum How to use checksums	`af273e600927a2fb72a64b73da81ab92e0a3b271f99498f7abb17a61a6d3f32e`
Upload date	Aug 13, 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/1424a6dbaaddcbf1051ba23507a95e5bbbab2987

Workflow

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

Artifact

Subject: pyenv_native-0.2.38.tar.gz
SHA-256 checksum: e77950a26a9bf549ad761d4634a81b998d590e66218c5804435257b768472020 Verifying attestations

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

Download URL	pyenv_native-0.2.38-py3-none-any.whl
Size	13.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`239de6adda143b11897130bc0e4b4e434131c7816691c02d57b8562c888c7161`
BLAKE2b-256 checksum How to use checksums	`13b2147130ee6d4b88457f04c017941728702982d6f31617982d5ee1a830d7ea`
Upload date	Aug 13, 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/1424a6dbaaddcbf1051ba23507a95e5bbbab2987

Workflow

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

Artifact

Subject: pyenv_native-0.2.38-py3-none-any.whl
SHA-256 checksum: 239de6adda143b11897130bc0e4b4e434131c7816691c02d57b8562c888c7161 Verifying attestations