convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
ImYourBoyRoy

pyenv-native

ImYourBoyRoy/pyenv-native

Gerenciador de versões Python nativo, rápido e multiplataforma.

Ver no GitHub
InicialPluginScore · de 0 a 100

Gerenciador 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-native

1 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

Estrelas
2
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
v0.8.3
Issues abertas
0
Contribuidores
2

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

Platforms Runtime PyPI License

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 venv support (replaces pyenv-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.

🤖 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)

PlatformCommandDescription
Windows (winget)winget install pyenv-nativeDirect, system-wide Windows installation
macOS / Linux (Homebrew)brew install imyourboyroy/pyenv-native/pyenv-nativeUniversal Unix taps management
Universal (pipx)pipx install pyenv-nativeIsolated 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/.pyenv over ~/.pyenv in scripts. The installer expands ~/path forms, but omitting --install-root is the most reliable option.
  • Use --force only when installing into a non-empty directory that does not already contain a pyenv-native install.

Upgrading

MethodCommand
Web installer (macOS/Linux)Re-run the curl ... install.sh command above
CLI self-updatepyenv self-update --yes
Windows (PowerShell)Re-run irm ... install.ps1 | iex
wingetwinget upgrade pyenv-native
Homebrewbrew upgrade imyourboyroy/pyenv-native/pyenv-native
pipxpipx 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:


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

Pyenv-Native GUI Animation


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 doctor to 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.


Created by: Roy Dawson IV | GitHub | PyPI | License: MIT

Ver o original no GitHub

Bom para

Relacionados