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

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.2
File Size Uploaded Provenance Actions
enchi-0.8.2.tar.gz 15.0 kB With provenance Details for enchi-0.8.2.tar.gz

Built distribution (wheel)

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

Total release size: 29.3 kB

Release files / enchi-0.8.2.tar.gz

Download URL enchi-0.8.2.tar.gz
Size 15.0 kB
Tags Source
SHA-256 checksum
How to use checksums
709c089c2ce7f7fffab909ebeadc8cd6fe015100b4fb65b4b22dd91c070b4135
BLAKE2b-256 checksum
How to use checksums
f82bbbb9c0611c0b753c96183f77d32c657d3ee505e1efb5f447397cca420629
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.2-py3-none-any.whl

Download URL enchi-0.8.2-py3-none-any.whl
Size 14.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
738a6b6d5cf1c6ea264e607e133a71d28b6791c48bdda82d2826b101bbe9b984
BLAKE2b-256 checksum
How to use checksums
ff0201edfddc0563b7df269022a97181340d2e7eceb695ab5a21632ab3612446
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.2

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