pyenv-native 0.2.18

Python install package for the native-first pyenv-native runtime bundles.

pyenv-native

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