https://github.com/sinusphi/venvipy
A GUI for managing Python virtual environments
https://github.com/sinusphi/venvipy
gui pyqt pyqt5 pyqt5-desktop-application python python3 venv virtualenvironment
Last synced: 4 months ago
JSON representation
A GUI for managing Python virtual environments
- Host: GitHub
- URL: https://github.com/sinusphi/venvipy
- Owner: sinusphi
- License: gpl-3.0
- Created: 2019-07-16T12:16:49.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2026-02-09T11:37:42.000Z (4 months ago)
- Last Synced: 2026-02-09T16:28:01.456Z (4 months ago)
- Topics: gui, pyqt, pyqt5, pyqt5-desktop-application, python, python3, venv, virtualenvironment
- Language: Python
- Homepage:
- Size: 346 MB
- Stars: 52
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
.. image:: https://raw.githubusercontent.com/sinusphi/venvipy/main/img/cover_slim.png
:alt: VenviPy cover
VenviPy
=======
**A GUI for managing multiple Python virtual environments**
.. image:: https://img.shields.io/pypi/v/venvipy?logo=pypi&logoColor=gold&color=darkcyan
:target: https://pypi.org/project/venvipy/
.. image:: https://img.shields.io/badge/python-3.7%2B-blue?logo=python&logoColor=gold
:target: https://www.python.org/downloads/
.. image:: https://img.shields.io/badge/pyqt-6.10.2-darkgreen?logo=qt&logoColor=green
:target: https://pypi.org/project/PyQt6/6.10.2/
.. image:: https://pepy.tech/badge/venvipy
:target: https://pepy.tech/project/venvipy
.. offf image:: https://img.shields.io/badge/platform-linux-orange?logo=linux&logoColor=FFE873
:target: https://www.linux.org/pages/download/
.. image:: https://img.shields.io/badge/code%20style-black-000000
:target: https://github.com/psf/black
.. image:: https://img.shields.io/badge/license-GPL%203.0-darkviolet
:target: https://github.com/sinusphi/venvipy/blob/main/LICENSE
.. image:: https://img.shields.io/badge/donations-paypal-darkblue?logo=paypal&logoColor=darkblue
:target: https://paypal.me/yserestou
|
Introduction
------------
*VenviPy* is a desktop GUI to create, manage, and maintain many Python virtual
environments from one place. It focuses on a fast, practical workflow:
* create environments via a wizard (Python version, location, pre-install packages)
* keep an overview table of all environments in a directory
* manage multiple environments at the same time with tabs
* install / update / inspect packages with context-menu actions
* open a console in the environment's context with one click
VenviPy was originally built for \*NIX systems. Windows support exists via a
platform abstraction layer, but should currently be considered experimental.
|
Screenshots
-----------
**Main menu**
.. image:: https://raw.githubusercontent.com/sinusphi/venvipy/refs/heads/main/img/screen-1_1.png
:alt: Application Main menu screenshot
|
.. image:: https://raw.githubusercontent.com/sinusphi/venvipy/refs/heads/main/img/screen-1_2.png
:alt: Application Main menu screenshot
|
**Wizard**
.. image:: https://raw.githubusercontent.com/sinusphi/venvipy/refs/heads/main/img/screen-2_1.png
:alt: Wizard screenshot 1
|
.. image:: https://raw.githubusercontent.com/sinusphi/venvipy/refs/heads/main/img/screen-2_2.png
:alt: Wizard screenshot 2
|
**Package installer**
.. image:: https://raw.githubusercontent.com/sinusphi/venvipy/refs/heads/main/img/screen-4_1.png
:alt: Package installer screenshot 1
|
.. image:: https://raw.githubusercontent.com/sinusphi/venvipy/refs/heads/main/img/screen-4_2.png
:alt: Package installer screenshot 2
|
**Console output**
.. image:: https://raw.githubusercontent.com/sinusphi/venvipy/refs/heads/main/img/screen-3.png
:alt: Console output screenshot
|
Key Features
------------
Environment management
~~~~~~~~~~~~~~~~~~~~~~
* Create virtual environments with a selectable Python version (3.3+)
* Clone an environment from a requirements file
* Generate requirements from an existing environment
* Add a description to an environment
Package management
~~~~~~~~~~~~~~~~~~
* Install and update Pip and Wheel with one click
* Search and install packages from `PyPI `__
* Install from requirements files
* Install from local project directories
* Install from a VCS URL *(currently git only)*
* Install from local or remote source archives
Inspection & tooling
~~~~~~~~~~~~~~~~~~~~
* List detailed information about installed packages
* Open a project's PyPI page in your browser.
Roadmap ideas
~~~~~~~~~~~~~
* Add option to create a launcher and add it for example to your taskbar or startmenu
* Run scripts in the environment's context
* Uninstall packages in a selected environment in Package Manager
* Clone environments, created by non-installed Python versions and has no requirements file
More to come.
|
Prerequisites
-------------
* Python **3.7+** (PyQt6 6.10.2 requires Python >= 3.7)
* A working ``venv`` module for the Python versions you want to use
Quick start
-----------
If you already have Python and pip available, this is the fastest path:
.. code-block:: bash
python -m venv .venv
source .venv/bin/activate # Windows (PowerShell): .venv\Scripts\Activate.ps1
pip install -U pip
pip install venvipy
venvipy
For full setup details and platform-specific notes, continue below.
Linux (Debian/Ubuntu)
~~~~~~~~~~~~~~~~~~~~~
Install the basics:
.. code-block:: bash
sudo apt update
sudo apt install python3-pip python3-venv
If you want to create venvs for a specific Python version, install its ``-venv`` package as well
(example for Python 3.10):
.. code-block:: bash
sudo apt install python3.10-venv
Windows
~~~~~~~
Install Python from python.org and make sure it is on ``PATH``. No additional system packages are required.
|
Installation
------------
Installing into the system Python is discouraged. Use a dedicated venv (recommended) or ``pipx``.
Recommended: install into a venv
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code-block:: bash
python -m venv .venv
# on Linux/macOS:
source .venv/bin/activate
# on Windows (PowerShell):
# .venv\\Scripts\\Activate.ps1
pip install -U pip
pip install venvipy
|
Development version (GitHub):
.. code-block:: bash
pip install -U pip
pip install git+https://github.com/sinusphi/venvipy.git
|
Alternative: install with pipx
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code-block:: bash
pipx install venvipy
|
Usage
-----
After installation you get the entry point:
.. code-block:: bash
venvipy
|
For command line options run:
.. code-block:: bash
venvipy --help
|
Running from source
-------------------
Clone and install dependencies:
.. code-block:: bash
git clone --depth 50 https://github.com/sinusphi/venvipy.git
cd venvipy
python -m venv .venv
# on Linux/macOS:
source .venv/bin/activate
# on Windows (PowerShell):
# .venv\\Scripts\\Activate.ps1
pip install -U pip
# minimal requirements to run VenviPy
pip install -r requirements/base.txt
# for development and testing
pip install -r requirements/dev.txt
# deployment and build dependencies
pip install -r requirements/deploy.txt
|
If you prefer a minimal manual install:
.. code-block:: bash
pip install requests beautifulsoup4 PyQt6==6.10.2
|
Run:
.. code-block:: bash
python venvipy/venvi.py
|
Contributing
------------
Contributions are welcome:
* `Pull requests `__
* `Bug reports `__
* `Feature requests `__