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

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.3.1
File	Size	Uploaded
pyenv_native-0.3.1.tar.gz	12.7 kB	Aug 17, 2026	Details

Built distribution (wheel)

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

Total release size: 26.0 kB

Release files / pyenv_native-0.3.1.tar.gz

Download URL	pyenv_native-0.3.1.tar.gz
Size	12.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`f718ba3c93a078b0c78837c888aa911d214be4cd5c26b0d3ed2f89a9ae147a81`
BLAKE2b-256 checksum How to use checksums	`b06b9a9b85971171e20951e3b51e8419f6a711adb013f39e86eb726033927b5b`
Upload date	Aug 17, 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/6e4635ca917fbfabfca49ebf6f217292ffa1040c

Workflow

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

Artifact

Subject: pyenv_native-0.3.1.tar.gz
SHA-256 checksum: f718ba3c93a078b0c78837c888aa911d214be4cd5c26b0d3ed2f89a9ae147a81 Verifying attestations

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

Download URL	pyenv_native-0.3.1-py3-none-any.whl
Size	13.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b99a37c204855c0f91a2226b7f0213bf1f90bc8df2b5387f589f4eac277b979b`
BLAKE2b-256 checksum How to use checksums	`9459d53e354001115bac64f0efaf769f0ae5a9b0f353ec3548dc03ca68ca4a46`
Upload date	Aug 17, 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/6e4635ca917fbfabfca49ebf6f217292ffa1040c

Workflow

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

Artifact

Subject: pyenv_native-0.3.1-py3-none-any.whl
SHA-256 checksum: b99a37c204855c0f91a2226b7f0213bf1f90bc8df2b5387f589f4eac277b979b Verifying attestations