pyenv-native
ImYourBoyRoy/pyenv-native
Gerenciador de versões Python nativo, rápido e multiplataforma.
Ver no GitHubGerenciador nativo de versões Python multiplataforma, reimplementado em Rust como alternativa ao pyenv tradicional. Elimina dependências de shell e oferece suporte nativo a Windows, Linux, macOS e Termux, com interface CLI de alto desempenho e GUI opcional.
Instalação
npx convez-ai ImYourBoyRoy/pyenv-native1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerenciar múltiplas versões de Python em máquinas Windows, Linux e macOS
- Integrar com ambientes de desenvolvimento local através de MCP/Claude
- Compilar e instalar Python do código-fonte em plataformas exóticas como Termux/Android
Veredito

Ferramenta sólida e madura para quem trabalha com múltiplas versões Python em Windows ou ambientes variados. O suporte MCP a torna interessante para automação com agentes Claude, mas ainda requer validação comunitária em produção fora de Windows.
README
A tradução para o português deste README ainda está na fila.
pyenv-native
A native-first, cross-platform Python version manager inspired by pyenv. Built for speed and reliability on Windows, Linux, and macOS.
pyenv-native is a native Rust reimplementation of the pyenv experience. It provides familiar workflows for version selection while removing shell and platform limitations, especially on Windows.
Current Status: Actively Maturing
pyenv-native is currently in active development. While it is used daily by its creators, it should be considered "production-intended" but still subject to community validation.
- Windows: Stable (Primary platform)
- Linux/macOS: Tested
- Android/Termux: Experimental (Requires manual setup for compilation)
Since Android/Termux does not ship with pre-built CPython binaries, pyenv-native automatically fetches and compiles Python from source. To prevent compilation failures, you must install the required compiler tools and system development libraries inside Termux first:
# 1. Update Termux package repositories
pkg update && pkg upgrade -y
# 2. Install required compilers, builders, and standard libraries
pkg install clang make pkg-config libffi openssl readline ncurses -y
After installing these prerequisites, running pyenv install <version> will compile and build your chosen Python runtime flawlessly on Android.
The Ecosystem
pyenv-native is more than a CLI; it is a native foundation for Python development.
💻 The CLI (Core Product)
The high-performance core. Manages Python installations, shims, and shell integration.
-
Native-First: No Bash dependency.
-
Opinionated Power: Built-in managed
venvsupport (replacespyenv-virtualenv). -
Validated Performance: Reliable version selection on Windows, Linux, and macOS.
-
Dashboard: Live view of your managed environments.
-
Visual Control: Install versions and manage venvs with one click.
-
Status: Stable on Windows; Experimental on Linux/macOS.
GUI Standalone (Latest)
- Windows: Download .exe
- Note: You may need to Right-click -> Properties -> Unblock if Windows SmartScreen blocks execution.
- Linux: Download Binary
- macOS (Apple Silicon): Download Binary
- macOS (Intel): Download Binary
- Note: On Linux/macOS, run
chmod +x <binary>in your terminal before launching.
- Note: On Linux/macOS, run
🤖 Agentic / MCP Support
A structured bridge for AI models like Claude or Gemini.
- Standardized: Built-in MCP server support.
- Model-Friendly: Allows AI agents to inspect, configure, and manage Python environments safely.
Installation
pyenv-native can be installed using modern package managers or standard interactive terminal scripts.
1. Package Managers (Recommended)
| Platform | Command | Description |
|---|---|---|
| Windows (winget) | winget install pyenv-native | Direct, system-wide Windows installation |
| macOS / Linux (Homebrew) | brew install imyourboyroy/pyenv-native/pyenv-native | Universal Unix taps management |
| Universal (pipx) | pipx install pyenv-native | Isolated Python application bootstrap |
[!NOTE] When installing via
pipx, you will run the self-installer command immediately after package installation:pyenv-native install --install-root ~/.pyenv
2. Interactive Shell Scripts (Fastest)
For single-line boots directly from standard terminal shells:
Windows (PowerShell)
irm https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.ps1 | iex
macOS / Linux / Android (Bash/Zsh)
Fresh install (defaults to $HOME/.pyenv):
curl -LsSf https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.sh | sh
Upgrade an existing install — re-run the same command. The installer detects an existing pyenv at the install root and upgrades in place. You do not need --force for normal upgrades.
curl -LsSf https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.sh | sh
Non-interactive upgrade (no prompts):
curl -LsSf https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.sh | sh -s -- --yes
If pyenv is already on your PATH, you can also use:
pyenv self-update --yes
Install root notes
- The default install root is
$HOME/.pyenv. You usually do not need--install-root. - If you set a custom root, prefer
$HOME/.pyenvover~/.pyenvin scripts. The installer expands~/pathforms, but omitting--install-rootis the most reliable option. - Use
--forceonly when installing into a non-empty directory that does not already contain apyenv-nativeinstall.
Upgrading
| Method | Command |
|---|---|
| Web installer (macOS/Linux) | Re-run the curl ... install.sh command above |
| CLI self-update | pyenv self-update --yes |
| Windows (PowerShell) | Re-run irm ... install.ps1 | iex |
| winget | winget upgrade pyenv-native |
| Homebrew | brew upgrade imyourboyroy/pyenv-native/pyenv-native |
| pipx | pipx upgrade pyenv-native then pyenv-native install --install-root "$HOME/.pyenv" |
After upgrading, refresh shims if python or python3 behave unexpectedly:
pyenv rehash
Uninstallation
If you need to remove pyenv-native and its shims, you can use the native CLI or standard web scripts:
1. Native CLI (Self-Contained)
If pyenv is already in your PATH, simply run:
pyenv self-uninstall
2. Interactive Shell Scripts
Windows (PowerShell)
irm https://github.com/imyourboyroy/pyenv-native/releases/latest/download/uninstall.ps1 | iex
macOS / Linux (Bash/Zsh)
curl -LsSf https://github.com/imyourboyroy/pyenv-native/releases/latest/download/uninstall.sh | sh -s -- --remove-root
Documentation Registry
Detailed technical guides and instructions:
- 📖 CLI Usage Guide — Core commands,
venvmanagement, and shell setup. - 🎨 GUI Dashboard Guide — Features, screenshots, and visual management.
- 🔗 MCP / Agent Guide — Integration for AI models and IDEs.
- 🏗️ Architecture — Native shims, version resolution, and design philosophy.
- 🗑️ Uninstallation Guide — Safely removing
pyenv-native.
Visual Previews
CLI Environment
$ pyenv versions
system
* 3.13.1 (set by C:\Users\Roy\.pyenv\version)
3.12.8
3.12.8/envs/api (managed venv)
Categorized Help Reference
SELECTION: global, local, shell, latest, version, version-name, prefix
PROVISIONING: install, available, versions, uninstall
ENVIRONMENT: venv (managed virtual environments)
INTERFACE: init, gui, rehash, shims, prompt, exec, completions
DIAGNOSTICS: doctor, status, config, root, which, whence
MAINTENANCE: self-update, self-uninstall
GUI Dashboard

Reporting Issues
If you encounter an issue, please open a GitHub Issue. To help us troubleshoot, please include:
- OS Version (e.g., Windows 11, macOS Sequoia, Ubuntu 24.04)
- Processor Architecture (e.g., x64, ARM64/Apple Silicon)
- Shell (e.g., PowerShell 7, Bash, Zsh, Fish)
- Relevant Logs (found in your
.pyenv/logs/directory) - Problematic Output (the full command and any error messages)
[!TIP] Run
pyenv doctorto get a quick summary of your environment health if the CLI is already installed.
Relationship to pyenv
pyenv-native is an independent reimplementation inspired by the pyenv experience. It is not affiliated with or endorsed by the official pyenv project. We thank the pyenv maintainers for shaping the standard for Python version management.