# Pyenv Native

> Native-first, cross-platform Python version manager inspired by pyenv.

- **Type:** MCP server
- **Install:** `agentstack add mcp-imyourboyroy-pyenv-native`
- **Verified:** Pending review
- **Seller:** [ImYourBoyRoy](https://agentstack.voostack.com/s/imyourboyroy)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ImYourBoyRoy](https://github.com/ImYourBoyRoy)
- **Source:** https://github.com/ImYourBoyRoy/pyenv-native

## Install

```sh
agentstack add mcp-imyourboyroy-pyenv-native
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

#  pyenv-native

Native Rust Python version manager inspired by `pyenv`. Ships **`pyenv`** (CLI), **`pyenv-mcp`** (agents), and **`pyenv gui`**.

Windows is the primary platform. Linux and macOS are tested. Android/Termux is experimental (source builds).

---

## Install

Pick the block for the machine you are on. Coding agents: run that block, then `pyenv doctor`. Do not guess a classic bash-pyenv install.

### Windows (PowerShell 7+)

```powershell
irm https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.ps1 | iex
pyenv doctor
```

### Linux / macOS / Termux

```bash
curl -fsSL https://github.com/imyourboyroy/pyenv-native/releases/latest/download/install.sh | sh
export PATH="$HOME/.pyenv/bin:$PATH"
eval "$("$HOME/.pyenv/bin/pyenv" init - bash)"   # use zsh or fish if that is your shell
pyenv doctor
```

Open a **new terminal** after install so shims are on PATH. On Termux, install compilers first: `pkg install clang make pkg-config libffi openssl readline ncurses`.

### pipx (any OS with Python)

```bash
pipx install pyenv-native
pyenv-native install --install-root "$HOME/.pyenv"
```

Winget and Homebrew manifests are generated on each release (`dist/winget/`, `dist/homebrew/`) but are **not published** yet. Do not run `winget install` or `brew install` for pyenv-native.

Full handbook (shells, tags, custom roots): [docs/INSTRUCTIONS.md](./docs/INSTRUCTIONS.md)

---

## After install

```bash
pyenv install 3.14          # latest matching 3.14.x
pyenv global 3.14
pyenv venv create 3.14 app
pyenv local 3.14/envs/app
pyenv which python
pyenv gui                   # optional desktop UI
```

Managed venvs live under `PYENV_ROOT/venvs//`. Version selection is **shell → local `.python-version` → parents → global → system**.

---

## Upgrade / uninstall

| | Windows | Linux / macOS |
| :--- | :--- | :--- |
| **Upgrade** | Re-run `install.ps1`, or `pyenv self-update --yes` | Re-run `install.sh`, or `pyenv self-update --yes` |
| **Uninstall** | `pyenv self-uninstall`, or `irm …/uninstall.ps1 \| iex` | `pyenv self-uninstall`, or `curl …/uninstall.sh \| sh -s -- --remove-root` |

pipx: `pipx upgrade pyenv-native` then `pyenv-native install --install-root "$HOME/.pyenv"`.

---

## For coding agents

1. If **pyenv-mcp** is connected: `get_toolkit_guide` → `resolve_project_environment` → `ensure_runtime` → `ensure_project_venv`. Details: [docs/MCP.md](./docs/MCP.md).
2. If MCP is missing: install with the OS command above, then CLI (`pyenv local`, `pyenv install`, `pyenv venv create`, `pyenv which python`).
3. Never `pip install` into an unknown global Python. Resolve the interpreter first.

Register MCP: `pyenv-mcp print-config` (paste into Cursor MCP settings). Quick JSON: `pyenv-mcp guide`.

**Install agent skills** (Cursor, Claude Code, Gemini CLI, Copilot, and more):

```text
Install the agent skills from https://github.com/imyourboyroy/pyenv-native
```

```powershell
# Windows (PowerShell 7+)
git clone --depth 1 https://github.com/imyourboyroy/pyenv-native.git
cd pyenv-native
./scripts/install-agent-skills.ps1 -Agent all
```

```bash
# macOS / Linux
git clone --depth 1 https://github.com/imyourboyroy/pyenv-native.git
cd pyenv-native
chmod +x ./scripts/install-agent-skills.sh
./scripts/install-agent-skills.sh --agent all
```

Guides: [docs/agent-skills/README.md](./docs/agent-skills/README.md) · [getting-started.md](./docs/agent-skills/getting-started.md)

---

## GUI

Launch with `pyenv gui` after a native install. Stable on Windows; experimental on Linux/macOS. Native bundles ship `pyenv-gui` next to `pyenv`. Standalone binaries and `.sha256` files are on [GitHub Releases](https://github.com/imyourboyroy/pyenv-native/releases/latest).

| Dashboard | Install Runtimes | Installed | Venvs |
| :---: | :---: | :---: | :---: |
|  |  |  |  |

More views and feature notes: [docs/GUI.md](./docs/GUI.md)

---

## Docs

| | |
| :--- | :--- |
| [INSTRUCTIONS](./docs/INSTRUCTIONS.md) | Install, shell init, workflows, troubleshooting |
| [CLI](./docs/CLI.md) | Command reference |
| [MCP](./docs/MCP.md) | Agent tools and recommended order |
| [GUI](./docs/GUI.md) | Desktop companion |
| [ARCHITECTURE](./docs/ARCHITECTURE.md) | Crate layout |

---

## Issues

[Open an issue](https://github.com/imyourboyroy/pyenv-native/issues) with OS, architecture, shell, `pyenv doctor` output, and logs from `.pyenv/logs/`. Run `pyenv preflight` before source installs on macOS, Linux, or Android.

`pyenv-native` is an independent reimplementation inspired by `pyenv`. It is not affiliated with or endorsed by the official pyenv project.

Created by: **Roy Dawson IV** | [GitHub](https://github.com/imyourboyroy) | [PyPI](https://pypi.org/user/ImYourBoyRoy/) | License: **MIT**

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ImYourBoyRoy](https://github.com/ImYourBoyRoy)
- **Source:** [ImYourBoyRoy/pyenv-native](https://github.com/ImYourBoyRoy/pyenv-native)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-imyourboyroy-pyenv-native
- Seller: https://agentstack.voostack.com/s/imyourboyroy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.