Skip to content

Fish shell tool for managing Python virtual environments


Notifications You must be signed in to change notification settings


Repository files navigation


Build Status PyPI Version Downloads

VirtualFish is a Python virtual environment manager for the Fish shell.

You can get started by reading the documentation. (It’s quite short… Promise!)

You can also get help on #virtualfish on OFTC (ircs://, the same network as the Fish IRC channel.

VirtualFish is maintained by Justin Mayer, and was originally created by Daisy Leigh Brenecki.

A quickstart, for the impatient

👉 Fish version 3.1 or higher is required. 👈

  1. python -m pip install virtualfish
  2. vf install
  3. Add VirtualFish to your prompt
  4. vf new myvirtualenv; which python

Read the documentation to find out more about project management, environment variable automation, auto-activation, and other plugins, as well as extending VirtualFish with events, virtualenvwrapper emulation, and more.