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

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.25
File	Size	Uploaded
pyenv_native-0.2.25.tar.gz	12.6 kB	Jul 13, 2026	Details

Built distribution (wheel)

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

Total release size: 25.9 kB

Release files / pyenv_native-0.2.25.tar.gz

Download URL	pyenv_native-0.2.25.tar.gz
Size	12.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`947f3091452e63a18ca38fc28b161f15666242bfec627713c9e8731b75ba30e6`
BLAKE2b-256 checksum How to use checksums	`5cbce8cf57fdabc34feb1830b0b9a7ed251762a7352733976ff70dced6ec1803`
Upload date	Jul 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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/009ee36f5eb3a6d053568b8f70af2a11383fabcb

Workflow

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

Artifact

Subject: pyenv_native-0.2.25.tar.gz
SHA-256 checksum: 947f3091452e63a18ca38fc28b161f15666242bfec627713c9e8731b75ba30e6 Verifying attestations

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

Download URL	pyenv_native-0.2.25-py3-none-any.whl
Size	13.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c2e62734de5a651b2fb7caee348d3e59b350441ec12b90e4eb8912115830b2b0`
BLAKE2b-256 checksum How to use checksums	`8fbc895baae92438dc716287a39a20bddac5d066e9d7278f3b82be590a8eb8f4`
Upload date	Jul 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

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

Workflow

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

Artifact

Subject: pyenv_native-0.2.25-py3-none-any.whl
SHA-256 checksum: c2e62734de5a651b2fb7caee348d3e59b350441ec12b90e4eb8912115830b2b0 Verifying attestations