enchi (Python install package)
enchi on PyPI is the Python convenience package for installing the native Enchi release bundles.
Enchi was called pyenv-native before; the pyenv-native PyPI package is now a thin wrapper that
depends on this one.
Those bundles install:
enchi(the CLI)enchi-mcp(the MCP server for coding agents)enchi-gui(desktop builds)
It exists for users who:
- already have Python installed,
- want a
piporpipxentrypoint, - still want the real runtime to remain native.
The console script this package adds is enchi-bootstrap, not enchi, so it never shadows the
real enchi binary the bundle installs.
Important principle
This package installs Enchi. It does not replace Enchi with a Python implementation.
Release selection behavior
By default, the package targets the latest published GitHub release.
What it does
- downloads native release bundles (
enchi-<platform>-<arch>), - verifies checksums,
- reads bundle metadata,
- extracts the bundle,
- runs the bundled installer (
enchi self-install), - installs the companion
enchi-mcpserver when the bundle provides it, - supports GitHub Release-based installs,
- works with Windows ZIP bundles and Linux/macOS
.tar.gzbundles.
Where the install goes is decided by enchi self-install: a fresh install uses ~/.enchi, and an
existing pyenv-native install keeps its ~/.pyenv root. Pass --install-root to choose one.
Quick start
pipx latest release
pipx install enchi
enchi-bootstrap install --github-repo imyourboyroy/pyenv-native
pip latest release
python -m pip install enchi
enchi-bootstrap install --github-repo imyourboyroy/pyenv-native
POSIX latest release
python -m pip install enchi
enchi-bootstrap install --github-repo imyourboyroy/pyenv-native
(imyourboyroy/pyenv-native is the GitHub repository that publishes the releases; it keeps that
name until the repository itself is renamed.)
Commands
enchi-bootstrap verify <bundle-archive> [--checksum-path <bundle.sha256>]
enchi-bootstrap download [--bundle-url <url> | --release-base-url <url> | --github-repo <owner/repo>] [--tag <tag>]
enchi-bootstrap install [--bundle-path <bundle-archive> | --release-base-url <url> | --github-repo <owner/repo>] [--tag <tag>] [--install-root <dir>]
python -m enchi_bootstrap runs the same commands.
Environment variables: ENCHI_BOOTSTRAP_RELEASE_BASE_URL and ENCHI_BOOTSTRAP_GITHUB_REPO supply
the download source. The earlier PYENV_NATIVE_BOOTSTRAP_* names are still read as a fallback.
Examples
Verify a local bundle:
enchi-bootstrap verify .\dist\enchi-windows-x64.zip --checksum-path .\dist\enchi-windows-x64.zip.sha256
Install from a local bundle:
enchi-bootstrap install --bundle-path .\dist\enchi-windows-x64.zip --checksum-path .\dist\enchi-windows-x64.zip.sha256
Install from the latest GitHub release into a chosen root:
enchi-bootstrap install --github-repo imyourboyroy/pyenv-native --install-root ~\.enchi
Install a POSIX bundle:
enchi-bootstrap install --bundle-path ./dist/enchi-linux-x64.tar.gz --checksum-path ./dist/enchi-linux-x64.tar.gz.sha256 --shell bash
Releases published before the rename only carry pyenv-native-<platform>-<arch> bundles. When a
release has no enchi-… bundle, the GitHub download falls back to that name.
Relationship to the main project
For the full project overview, install scripts, release-bundle flow, and command reference, see the main repository README:
Metadata
Release files for enchi 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| enchi-0.8.1.tar.gz | 15.0 kB | With provenance | Details for enchi-0.8.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| enchi-0.8.1-py3-none-any.whl | Python 3 | none | any | Details for enchi-0.8.1-py3-none-any.whl |
Total release size: 29.3 kB
Release files / enchi-0.8.1.tar.gz
| Download URL | enchi-0.8.1.tar.gz |
|---|---|
| Size | 15.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9565f32a5477e9eddd5df1cabd92eb2f59c59cdacbe59b73f2cc500b1cd67d47
|
|
BLAKE2b-256 checksum How to use checksums |
413b62d2fb6f99fb3f6e62f84cfc4a75825393778512a511303be18147223a2e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logRelease files / enchi-0.8.1-py3-none-any.whl
| Download URL | enchi-0.8.1-py3-none-any.whl |
|---|---|
| Size | 14.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0df8d1d8cfb1e5b59617628d497c98df1121b039fd34fc9fbb15d99728a4fdc0
|
|
BLAKE2b-256 checksum How to use checksums |
e427afd5a06ed51940169de866e7710fb56456358fcc060dcd603663fedbfa6a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logSecurity for enchi 0.8.1
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for enchi-0.8.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.