tn-venv-gui

A graphical frontend for tn-venv, the batteries-included virtualenv alternative. Built with Tkinter so it runs anywhere Python's standard library does — no extra GUI dependencies required.

Features

• Pick the destination folder and Python interpreter from a dropdown (auto-populated through tn_venv.discovery.discover).
• Toggle the most useful tn-venv flags without remembering the CLI: --clear, --upgrade, --system-site-packages, --upgrade-pip, --offline, --symlinks / --copies, custom prompt, and a list of preinstalled packages or requirements files.
• Real-time, color-coded log panel that streams tn-venv's output as the environment is created.
• Background worker so the UI stays responsive while pip install runs.
• Saves your last-used settings to ~/.tn_venv_gui.json so you can pick up where you left off.

Installation

The GUI requires Python ≥ 3.9 and the tn-venv package (≥ 0.2.0).

# from a clone of this repository
pip install -e .

# or directly from PyPI
pip install tn-venv-gui

Usage

After installation a tn-venv-gui console script is available:

tn-venv-gui

Or, without installing:

python -m tn_venv_gui

As an optional subcommand of tn-venv

Because the package is also a tn-venv plugin, running tn-venv-gui once drops a .pth file in site-packages/ that auto-imports the package on every Python startup. From that point on, tn-venv advertises and honours the gui subcommand:

tn-venv                       # create ./.venv as usual
tn-venv gui                   # open the GUI window
tn-venv gui --help            # detailed help for the subcommand
tn-venv help gui              # alias for the same help
tn-venv --list-pythons        # original tn-venv command, unchanged
tn-venv .venv --dry-run       # original dry-run output, unchanged

The tn-venv --help epilog automatically grows a section listing every subcommand contributed by plugins:

optional subcommands provided by plugins:
  gui    launch the tn-venv-gui graphical frontend

Run 'tn-venv help <subcommand>' (or 'tn-venv <subcommand> --help') for details on a specific subcommand.

Knobs:

The GUI plugin is also registered as a standard [project.entry-points."tn_venv.plugins"] entry point, so once tn-venv wires load_plugins() into its CLI (the loader is already public API in tn-venv 1.0.0) the subcommand becomes discoverable without any monkey-patching.

License

Tokenoodle-Everything License v1.0 (see License.txt). This is not an OSI-approved open source license and forbids commercial use without permission.