{"id":47261611,"url":"https://github.com/imyourboyroy/pyenv-native","last_synced_at":"2026-07-13T13:00:51.527Z","repository":{"id":344458490,"uuid":"1181532164","full_name":"ImYourBoyRoy/pyenv-native","owner":"ImYourBoyRoy","description":"Native-first, cross-platform Python version manager inspired by pyenv.","archived":false,"fork":false,"pushed_at":"2026-07-13T11:08:39.000Z","size":2169,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-13T11:12:50.475Z","etag":null,"topics":["agentic-tools","agentic-workflows","ai-agent","ai-agents","automation","cli","cross-platform","developer-tools","linux","macos","mcp","model-context-protocol","pyenv","python","python-installation","python-version-manager","rust","shim","version-manager","windows"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ImYourBoyRoy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-14T09:12:53.000Z","updated_at":"2026-07-13T11:08:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ImYourBoyRoy/pyenv-native","commit_stats":null,"previous_names":["imyourboyroy/pyenv-native"],"tags_count":53,"template":false,"template_full_name":null,"purl":"pkg:github/ImYourBoyRoy/pyenv-native","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImYourBoyRoy%2Fpyenv-native","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImYourBoyRoy%2Fpyenv-native/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImYourBoyRoy%2Fpyenv-native/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImYourBoyRoy%2Fpyenv-native/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ImYourBoyRoy","download_url":"https://codeload.github.com/ImYourBoyRoy/pyenv-native/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImYourBoyRoy%2Fpyenv-native/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35423100,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-13T02:00:06.543Z","response_time":119,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-tools","agentic-workflows","ai-agent","ai-agents","automation","cli","cross-platform","developer-tools","linux","macos","mcp","model-context-protocol","pyenv","python","python-installation","python-version-manager","rust","shim","version-manager","windows"],"created_at":"2026-03-14T23:26:37.030Z","updated_at":"2026-07-13T13:00:51.517Z","avatar_url":"https://github.com/ImYourBoyRoy.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"crates/pyenv-gui/icons/icon.svg\" width=\"48\" height=\"48\" valign=\"middle\"\u003e pyenv-native\n\n![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20Linux%20%7C%20macOS-2563eb?style=for-the-badge)\n![Runtime](https://img.shields.io/badge/runtime-Rust-D97706?style=for-the-badge\u0026logo=rust\u0026logoColor=white)\n![PyPI](https://img.shields.io/badge/PyPI-pip%20%2F%20pipx-3775A9?style=for-the-badge\u0026logo=pypi\u0026logoColor=white)\n![License](https://img.shields.io/badge/license-MIT-15803D?style=for-the-badge)\n\n**A native-first, cross-platform Python version manager inspired by `pyenv`. Built for speed and reliability on Windows, Linux, and macOS.**\n\n`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.\n\n---\n\n## Current Status: Actively Maturing\n\n`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.\n\n- **Windows**: Stable (Primary platform)\n- **Linux/macOS**: Tested\n- **Android/Termux**: **Experimental** (Requires manual setup for compilation)\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eAndroid / Termux Build Prerequisites\u003c/b\u003e\u003c/summary\u003e\n\u003cbr /\u003e\n\nSince 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:\n\n```bash\n# 1. Update Termux package repositories\npkg update \u0026\u0026 pkg upgrade -y\n\n# 2. Install required compilers, builders, and standard libraries\npkg install clang make pkg-config libffi openssl readline ncurses -y\n```\n\nAfter installing these prerequisites, running `pyenv install \u003cversion\u003e` will compile and build your chosen Python runtime flawlessly on Android.\n\u003c/details\u003e\n\n---\n\n## The Ecosystem\n\n`pyenv-native` is more than a CLI; it is a native foundation for Python development.\n\n### 💻 [The CLI (Core Product)](./docs/CLI.md)\n\nThe high-performance core. Manages Python installations, shims, and shell integration.\n\n- **Native-First**: No Bash dependency.\n- **Opinionated Power**: Built-in managed `venv` support (replaces `pyenv-virtualenv`).\n- **Validated Performance**: Reliable version selection on Windows, Linux, and macOS.\n\n- **Dashboard**: Live view of your managed environments.\n- **Visual Control**: Install versions and manage venvs with one click.\n- **Status**: Stable on Windows; Experimental on Linux/macOS.\n\n#### GUI Standalone (Latest)\n\n- **Windows**: [Download .exe](https://github.com/imyourboyroy/pyenv-native/releases/latest/download/pyenv-gui-windows-x64.exe)\n  - *Note: You may need to Right-click -\u003e Properties -\u003e **Unblock** if Windows SmartScreen blocks execution.*\n- **Linux**: [Download Binary](https://github.com/imyourboyroy/pyenv-native/releases/latest/download/pyenv-gui-linux-x64)\n- **macOS (Apple Silicon)**: [Download Binary](https://github.com/imyourboyroy/pyenv-native/releases/latest/download/pyenv-gui-macos-arm64)\n- **macOS (Intel)**: [Download Binary](https://github.com/imyourboyroy/pyenv-native/releases/latest/download/pyenv-gui-macos-x64)\n  - *Note: On Linux/macOS, run `chmod +x \u003cbinary\u003e` in your terminal before launching.*\n\n### 🤖 [Agentic / MCP Support](./docs/MCP.md)\n\nA structured bridge for AI models like Claude or Gemini.\n\n- **Standardized**: Built-in MCP server support.\n- **Model-Friendly**: Allows AI agents to inspect, configure, and manage Python environments safely.\n\n---\n\n## Installation\n\n`pyenv-native` can be installed using modern package managers or standard interactive terminal scripts.\n\n### 1. Package Managers (Recommended)\n\n| Platform | Command | Description |\n| :--- | :--- | :--- |\n| **Windows (winget)** | `winget install pyenv-native` | Direct, system-wide Windows installation |\n| **macOS / Linux (Homebrew)** | `brew install imyourboyroy/pyenv-native/pyenv-native` | Universal Unix taps management |\n| **Universal (pipx)** | `pipx install pyenv-native` | Isolated Python application bootstrap |\n\n\u003e [!NOTE]\n\u003e When installing via `pipx`, you will run the self-installer command immediately after package installation:\n\u003e ```bash\n\u003e pyenv-native install --install-root ~/.pyenv\n\u003e ```\n\n---\n\n### 2. Interactive Shell Scripts (Fastest)\n\nFor single-line boots directly from standard terminal shells:\n\n#### Windows (PowerShell)\n```powershell\nirm https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.ps1 | iex\n```\n\n#### macOS / Linux / Android (Bash/Zsh)\n\n**Fresh install** (defaults to `$HOME/.pyenv`):\n\n```bash\ncurl -LsSf https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.sh | sh\n```\n\n**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.\n\n```bash\ncurl -LsSf https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.sh | sh\n```\n\nNon-interactive upgrade (no prompts):\n\n```bash\ncurl -LsSf https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.sh | sh -s -- --yes\n```\n\nIf `pyenv` is already on your PATH, you can also use:\n\n```bash\npyenv self-update --yes\n```\n\n**Install root notes**\n\n- The default install root is `$HOME/.pyenv`. You usually do **not** need `--install-root`.\n- 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.\n- Use `--force` only when installing into a non-empty directory that does **not** already contain a `pyenv-native` install.\n\n---\n\n## Upgrading\n\n| Method | Command |\n| :--- | :--- |\n| **Web installer (macOS/Linux)** | Re-run the `curl ... install.sh` command above |\n| **CLI self-update** | `pyenv self-update --yes` |\n| **Windows (PowerShell)** | Re-run `irm ... install.ps1 \\| iex` |\n| **winget** | `winget upgrade pyenv-native` |\n| **Homebrew** | `brew upgrade imyourboyroy/pyenv-native/pyenv-native` |\n| **pipx** | `pipx upgrade pyenv-native` then `pyenv-native install --install-root \"$HOME/.pyenv\"` |\n\nAfter upgrading, refresh shims if `python` or `python3` behave unexpectedly:\n\n```bash\npyenv rehash\n```\n\n---\n\n## Uninstallation\n\nIf you need to remove `pyenv-native` and its shims, you can use the native CLI or standard web scripts:\n\n### 1. Native CLI (Self-Contained)\nIf `pyenv` is already in your PATH, simply run:\n```bash\npyenv self-uninstall\n```\n\n### 2. Interactive Shell Scripts\n\n#### Windows (PowerShell)\n```powershell\nirm https://github.com/imyourboyroy/pyenv-native/releases/latest/download/uninstall.ps1 | iex\n```\n\n#### macOS / Linux (Bash/Zsh)\n```bash\ncurl -LsSf https://github.com/imyourboyroy/pyenv-native/releases/latest/download/uninstall.sh | sh -s -- --remove-root\n```\n\n---\n\n## Agent skills (Cursor, Claude Code, Gemini, Copilot, and more)\n\nThis repo ships **agent skills** so coding agents follow pyenv-native / pyenv-mcp workflows instead of guessing Python setup.\n\n### Tell your agent (copy-paste)\n\n```text\nInstall the agent skills from https://github.com/imyourboyroy/pyenv-native. Clone the repo, then run scripts/install-agent-skills.ps1 -Agent all on Windows (PowerShell 7+) or scripts/install-agent-skills.sh --agent all on macOS/Linux. Install for Cursor, Claude Code, Gemini CLI, Antigravity, GitHub Copilot, Windsurf, OpenCode, and Kiro.\n```\n\n### One-shot (no manual cd)\n\n**Windows (PowerShell 7+):**\n\n```powershell\n$repo = \"https://github.com/imyourboyroy/pyenv-native\"\n$dir = Join-Path $env:TEMP \"agent-skills-$(Get-Random)\"\ngit clone --depth 1 $repo $dir\n\u0026 (Join-Path $dir \"scripts/install-agent-skills.ps1\") -RepoRoot $dir -Agent all\n```\n\n**macOS / Linux:**\n\n```bash\nrepo=\"https://github.com/imyourboyroy/pyenv-native\"\ndir=\"$(mktemp -d)\"\ngit clone --depth 1 \"$repo\" \"$dir\"\nchmod +x \"$dir/scripts/install-agent-skills.sh\"\n\"$dir/scripts/install-agent-skills.sh\" --repo-root \"$dir\" --agent all\n```\n\n### Quick install\n\n**Windows (PowerShell 7+):**\n\n```powershell\ngit clone --depth 1 https://github.com/imyourboyroy/pyenv-native.git\ncd pyenv-native\n./scripts/install-agent-skills.ps1 -Agent all\n```\n\n**macOS / Linux:**\n\n```bash\ngit clone --depth 1 https://github.com/imyourboyroy/pyenv-native.git\ncd pyenv-native\nchmod +x ./scripts/install-agent-skills.sh\n./scripts/install-agent-skills.sh --agent all\n```\n\nFull guides for every supported agent: **[docs/agent-skills/README.md](./docs/agent-skills/README.md)** · **[Getting started](./docs/agent-skills/getting-started.md)**\n\n---\n\n## Documentation Registry\n\nDetailed technical guides and instructions:\n\n- 📖 **[CLI Usage Guide](./docs/CLI.md)** — Core commands, `venv` management, and shell setup.\n- 🎨 **[GUI Dashboard Guide](./docs/GUI.md)** — Features, screenshots, and visual management.\n- 🔗 **[MCP / Agent Guide](./docs/MCP.md)** — Integration for AI models and IDEs.\n- 🤖 **[Agent Skills Install](./docs/agent-skills/README.md)** — Cursor, Claude Code, Gemini CLI, Antigravity, Copilot, Windsurf, OpenCode, Kiro.\n- 🏗️ **[Architecture](./docs/ARCHITECTURE.md)** — Native shims, version resolution, and design philosophy.\n- 🗑️ **[Uninstallation Guide](./docs/INSTRUCTIONS.md#uninstallation)** — Safely removing `pyenv-native`.\n\n---\n\n## Visual Previews\n\n### CLI Environment\n\n```bash\n$ pyenv versions\n  system\n* 3.13.1 (set by C:\\Users\\Roy\\.pyenv\\version)\n  3.12.8\n  3.12.8/envs/api  (managed venv)\n```\n\n### Categorized Help Reference\n\n```text\nSELECTION:      global, local, shell, latest, version, version-name, prefix\nPROVISIONING:   install, available, versions, uninstall\nENVIRONMENT:    venv (managed virtual environments)\nINTERFACE:      init, gui, rehash, shims, prompt, exec, completions\nDIAGNOSTICS:    doctor, status, config, root, which, whence\nMAINTENANCE:    self-update, self-uninstall\n```\n\n### GUI Dashboard\n\n![Pyenv-Native GUI Animation](docs/screenshots/animated_gui.webp)\n\n---\n\n## Reporting Issues\n\nIf you encounter an issue, please [open a GitHub Issue](https://github.com/imyourboyroy/pyenv-native/issues). To help us troubleshoot, please include:\n\n- **OS Version** (e.g., Windows 11, macOS Sequoia, Ubuntu 24.04)\n- **Processor Architecture** (e.g., x64, ARM64/Apple Silicon)\n- **Shell** (e.g., PowerShell 7, Bash, Zsh, Fish)\n- **Relevant Logs** (found in your `.pyenv/logs/` directory)\n- **Problematic Output** (the full command and any error messages)\n\n\u003e [!TIP]\n\u003e Run `pyenv doctor` to get a quick summary of your environment health if the CLI is already installed.\n\n---\n\n## Relationship to pyenv\n\n`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.\n\n---\n\nCreated by: **Roy Dawson IV** | [GitHub](https://github.com/imyourboyroy) | [PyPI](https://pypi.org/user/ImYourBoyRoy/) | License: **MIT**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimyourboyroy%2Fpyenv-native","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimyourboyroy%2Fpyenv-native","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimyourboyroy%2Fpyenv-native/lists"}