Skip to main content

enchi (Python install package)

PyPI Channel Runtime License

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 pip or pipx entrypoint,
  • 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-mcp server when the bundle provides it,
  • supports GitHub Release-based installs,
  • works with Windows ZIP bundles and Linux/macOS .tar.gz bundles.

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

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for enchi 0.8.3
File Size Uploaded Provenance Actions
enchi-0.8.3.tar.gz 15.0 kB With provenance Details for enchi-0.8.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for enchi 0.8.3
File Interpreter ABI Platform Actions
enchi-0.8.3-py3-none-any.whl Python 3 none any Details for enchi-0.8.3-py3-none-any.whl

Total release size: 29.3 kB

Release files / enchi-0.8.3.tar.gz

Download URL enchi-0.8.3.tar.gz
Size 15.0 kB
Tags Source
SHA-256 checksum
How to use checksums
1912c697300125d44b0540b3a327f0620de7cdf96e324131a3285e5fa062b892
BLAKE2b-256 checksum
How to use checksums
b25ca6efde3ea253c74b47bc7a4345d5e09baf20d25a2a426ac31105bdf8caf1
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 log

Release files / enchi-0.8.3-py3-none-any.whl

Download URL enchi-0.8.3-py3-none-any.whl
Size 14.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e399068d24765400d762ab49d8e9b2a359d04f2cd22f20beb1d23ede7486ec9e
BLAKE2b-256 checksum
How to use checksums
2c1cff5747a69f1243c20b649b3fa64db76183023189c0736f39733ef8a62ffe
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 log

Security for enchi 0.8.3

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.

Select from 2 files

Attestation for enchi-0.8.3.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 log

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

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page