Skip to content

GUI.md

Latest commit

 

History

History
59 lines (39 loc) · 2.11 KB

GUI.md

File metadata and controls

59 lines (39 loc) · 2.11 KB

Pyenv Native GUI Companion

The Pyenv Native GUI is a premium desktop dashboard built with Tauri v2, providing a visual interface for managing your Python environments.

Important

Status: Experimental / Preview The GUI is currently most stable on Windows. While macOS and Linux builds are possible from source, they are not yet fully validated or provided as pre-compiled bundles.

Features

  • Dashboard: Live view of your active Python version, managed venvs, and pyenv root.
  • Visual Management: Browse and install from the full CPython/PyPy catalog with a single click.
  • Venv Manager: Create, list, and delete named virtual environments graphically.
  • Settings: Configure registry integration, architecture preferences, and pip bootstrapping.
  • Self-Update: Check for and install pyenv-native updates directly from the UI.

Visual Tour

Pyenv-Native GUI Animation

View Screen Gallery
Dashboard Installed Versions Virtual Envs
Dashboard Installed Versions Virtual Envs
Available Targets Settings About
Available Settings About

Installation & Launch

Windows

The GUI is included in the default Windows release bundle. If pyenv is on your path, you can launch it via:

# Coming in a future update: pyenv gui launch
# For now, use the dev script or the Start Menu shortcut
.\scripts\launch_gui.ps1

Building from Source (macOS/Linux)

You can build the GUI from source if you have the Rust toolchain installed:

cargo build --release -p pyenv-gui

Note: Linux users will need webkit2gtk-4.1 and other Tauri system dependencies installed.

The GUI is designed as a companion to the core CLI. All changes made in the GUI are instantly reflected in your terminal and vice versa.