# Install pyenv with Homebrew, apt, Nix, pacman, scoop, zypper, dnf

Python version management. Version 2.7.3 via Homebrew; verified 2026-06-24.

## Install

```sh
sudo av install brew:pyenv
```

## Agent safety answer

pyenv manages Python versions and can affect interpreter resolution for agent-run tools.

- **Credential access:** Reads project config and environment variables but not secrets by default.
- **Remote mutation:** Usually local, but installed Python tools may call remote services.
- **Publish/artifact risk:** Can influence build artifacts by changing interpreter versions.
- **Recommended control:** Gate plugin installs and commands that run project scripts with secrets.
- **Agent-use guidance:** Allow version switching and inspection; require approval before plugin installs or secret-backed scripts.

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install pyenv
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install pyenv
```

  Evidence: Debian stable package indexes: pyenv from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#pyenv
```

  Evidence: nixpkgs package indexes: pkgs/by-name/py/pyenv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S pyenv
```

  Evidence: Arch Linux sync databases: pyenv from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install pyenv
```

  Evidence: openSUSE Tumbleweed package metadata: pyenv from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

- dnf (92%):

```sh
sudo dnf install python3-build
```

  Evidence: Fedora Rawhide package metadata: python3-build from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Ubuntu apt (92%):

```sh
sudo apt install python3-build
```

  Evidence: Ubuntu 24.04 LTS package indexes: python3-build from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz

### Windows

- Scoop (92%):

```sh
scoop install main/pyenv
```

  Evidence: Scoop official bucket manifest trees: bucket/pyenv.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:pyenv
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/pyenv>
- **Version:** 2.7.3
- **Source summary:** Python version management
- **Homepage:** <https://github.com/pyenv/pyenv>
- **Repository:** <https://github.com/pyenv/pyenv>
- **Upstream docs:** <https://github.com/pyenv/pyenv#readme>
- **License:** MIT
- **Source archive:** <https://github.com/pyenv/pyenv/archive/refs/tags/v2.7.3.tar.gz>
- **Last updated:** 2026-06-24T05:04:42Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- pyenv (cli)
- pyenv-install (cli)
- pyenv-uninstall (cli)
- python-build (cli)
- pyenv (alias)
- pyenv-install (alias)
- pyenv-uninstall (alias)
- python-build (alias)

## Dependencies

- autoconf
- openssl@3
- pkgconf
- readline

## Uses from macOS

- bzip2
- libffi
- ncurses
- xz

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sequoia, sonoma, tahoe, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.7.3
- Package-manager updated: 2026-06-24
- Local data: ok
- Upstream repository: https://github.com/pyenv/pyenv
- Upstream latest detected: v2.7.3 (current)

## Security Notes

runtime version manager.

- **Geiger risk:** orange / high
- runtime version manager
- **Approval gate rules:** 5


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: .python-version, $(pyenv root)/version
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** pyenv
- **Version Scheme:** 1
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - pyenv - 2.5.4-1: normalized package name match | Debian stable package indexes: pyenv from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Simple Python version management | https://github.com/pyenv/pyenv
- Nix - pyenv: normalized package name match | nixpkgs package indexes: pkgs/by-name/py/pyenv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - pyenv - 1:2.7.2-1: normalized package name match | Arch Linux sync databases: pyenv from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Easily switch between multiple versions of Python | https://github.com/pyenv/pyenv
- zypper - pyenv - 2.6.27-1.2: normalized package name match | openSUSE Tumbleweed package metadata: pyenv from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Python Version Management | https://github.com/pyenv/pyenv
- zypper - pyenv-bash-completion - 2.6.27-1.2: normalized package name match | openSUSE Tumbleweed package metadata: pyenv-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash completion for pyenv | https://github.com/pyenv/pyenv
- zypper - pyenv-fish-completion - 2.6.27-1.2: normalized package name match | openSUSE Tumbleweed package metadata: pyenv-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish completion for pyenv | https://github.com/pyenv/pyenv
- zypper - pyenv-zsh-completion - 2.6.27-1.2: normalized package name match | openSUSE Tumbleweed package metadata: pyenv-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh completion for pyenv | https://github.com/pyenv/pyenv
- Scoop - main/pyenv: normalized package name match | Scoop official bucket manifest trees: bucket/pyenv.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- Debian apt - python3-build - 1.2.2-2: installed executable or alias match | Debian stable package indexes: python3-build from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Simple, correct PEP517 package builder (Python 3) | https://github.com/pypa/build
- Debian apt - python3-build-doc - 1.2.2-2: installed executable or alias match | Debian stable package indexes: python3-build-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Simple, correct PEP517 package builder (documentation) | https://github.com/pypa/build
- Ubuntu apt - python3-build - 1.0.3-2: installed executable or alias match | Ubuntu 24.04 LTS package indexes: python3-build from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Simple, correct PEP517 package builder (Python 3) | https://github.com/pypa/build
- Ubuntu apt - python3-build-doc - 1.0.3-2: installed executable or alias match | Ubuntu 24.04 LTS package indexes: python3-build-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Simple, correct PEP517 package builder (documentation) | https://github.com/pypa/build
- dnf - python3-build - 1.5.0-4.fc45: installed executable or alias match | Fedora Rawhide package metadata: python3-build from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A simple, correct PEP517 package builder | https://github.com/pypa/build
- dnf - python3-build+uv - 1.5.0-4.fc45: installed executable or alias match | Fedora Rawhide package metadata: python3-build+uv from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Metapackage for python3-build: uv extras | https://github.com/pypa/build
- dnf - python3-build+virtualenv - 1.5.0-4.fc45: installed executable or alias match | Fedora Rawhide package metadata: python3-build+virtualenv from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Metapackage for python3-build: virtualenv extras | https://github.com/pypa/build
- pacman - python-build - 1.4.3-1: installed executable or alias match | Arch Linux sync databases: python-build from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A simple, correct Python build frontend | https://github.com/pypa/build


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [autoconf](https://www.automicvault.com/pkg/brew/autoconf/) - Runtime dependency declared by Homebrew.
- [openssl@3](https://www.automicvault.com/pkg/brew/openssl-3/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Runtime dependency declared by Homebrew.
- [pyenv-pip-migrate](https://www.automicvault.com/pkg/brew/pyenv-pip-migrate/) - Popular package that depends on this formula.
- [pyenv-virtualenv](https://www.automicvault.com/pkg/brew/pyenv-virtualenv/) - Popular package that depends on this formula.
- [pyenv-virtualenvwrapper](https://www.automicvault.com/pkg/brew/pyenv-virtualenvwrapper/) - Popular package that depends on this formula.
- [n](https://www.automicvault.com/pkg/brew/n/) - Shares av.db curated category or tags: cli, language-runtime, shell, version-manager.
- [plenv](https://www.automicvault.com/pkg/brew/plenv/) - Shares av.db curated category or tags: cli, language-runtime, shell, version-manager.
- [coconut](https://www.automicvault.com/pkg/brew/coconut/) - Shares av.db curated category or tags: cli, language-runtime, python.
- [cython](https://www.automicvault.com/pkg/brew/cython/) - Shares av.db curated category or tags: cli, language-runtime, python.
- [elan-init](https://www.automicvault.com/pkg/brew/elan-init/) - Shares av.db curated category or tags: cli, language-runtime, version-manager.
- [hy](https://www.automicvault.com/pkg/brew/hy/) - Shares av.db curated category or tags: cli, language-runtime, python.
- [jython](https://www.automicvault.com/pkg/brew/jython/) - Shares av.db curated category or tags: cli, language-runtime, python.
- [kerl](https://www.automicvault.com/pkg/brew/kerl/) - Shares av.db curated category or tags: cli, language-runtime, version-manager.
- [ruby-build](https://www.automicvault.com/pkg/brew/ruby-build/) - Local metadata places this package in an adjacent workflow. Shared terms: autoconf, build, cli, install, language.

## Combined YAML source

View the package source record on GitHub. [combined/pyenv.yml](https://github.com/automic-vault/db/blob/main/combined/pyenv.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- approval-gate seed metadata
- package-page enrichment
- curated configuration and credential file locations
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer
