phy is an open-source Python library providing a graphical user interface for visualization and manual curation of large-scale electrophysiological data. It is optimized for high-density multielectrode arrays containing hundreds to thousands of recording sites, especially Neuropixels recordings.
Release candidate available:
phy 2.1.0rc1is available for testing on PyPI. This maintenance-focused release candidate aims to improve installation and GUI reliability on current systems. See the release notes for installation instructions, compatibility notes, and testing guidance.
As of March 2026, phy 2.1.0rc1 is a maintenance-focused release candidate for the current 2.x line.
The main goals of this release are:
- dependency and packaging modernization
- replacing a fragile legacy web-based GUI component with a Qt-native implementation
- improving display reliability on modern systems
- collecting feedback from beta testers before a final
2.1.0release
Dataset formats are unchanged. Some plugins that relied on internal HTML or web-based GUI components may need updates.
If you would like to test this release candidate, install it in a fresh Python 3.10+ environment:
python -m pip install --upgrade pip
pip install "phy==2.1.0rc1"Please report any issues or compatibility regressions on GitHub issues.
phy currently provides three main entry points:
- Template GUI: the main and recommended workflow for datasets sorted with KiloSort and Spyking Circus
- Kwik GUI: a legacy workflow for datasets sorted with klusta and klustakwik2
- Trace GUI: an experimental raw-data viewer for opening continuous electrophysiology recordings directly
Current testing and maintenance work is focused on modern Linux, macOS, and Windows environments. Linux is still the best-covered platform, but cross-platform testing is active during the 2.1.0rc1 cycle.
Install phy in a fresh Python 3.10+ environment:
python -m pip install --upgrade pip
pip install phyThis installs the GUI runtime dependencies as part of the main package.
If you plan to use the legacy Kwik GUI, also install:
pip install klusta klustakwik2For release-candidate testing specifically, install the exact RC version instead:
pip install "phy==2.1.0rc1"Open the Template GUI on a spike sorting output directory containing params.py:
cd path/to/my/spikesorting/output
phy template-gui params.pyOther useful commands:
phy template-describe params.py
phy kwik-gui path/to/file.kwik
phy trace-gui path/to/raw.bin --sample-rate 30000 --dtype int16 --n-channels 384Use the Template GUI for current template-based workflows such as KiloSort and Spyking Circus.
phy template-gui params.pyTo inspect a dataset from the terminal without launching the GUI:
phy template-describe params.pyThe Kwik GUI is still available for legacy kwik datasets, but it is no longer the primary workflow.
phy kwik-gui path/to/file.kwikThe Trace GUI is still experimental and opens raw electrophysiology recordings directly.
phy trace-gui path/to/raw.bin --sample-rate 30000 --dtype int16 --n-channels 384You can also launch phy from Python or IPython, which can be useful for debugging or profiling:
from phy.apps.template import template_gui
template_gui("params.py")To work on phy itself in a fresh checkout:
git clone git@github.com:cortex-lab/phy.git
cd phy
uv sync --devIf you are working on phy together with a local checkout of phylib, install that checkout in editable mode:
git clone git@github.com:cortex-lab/phylib.git
cd phylib
pip install -e . --upgradephy is developed and maintained by Cyrille Rossant.
Contributors to the repository are:
- Maxime Beau
- Alessio Buccino
- Thad Czuba
- Michael Economo
- Einsied
- Cedric Gestes
- Yaroslav Halchenko
- Max Hunter
- Shabnam Kadir
- Zach McKenzie
- Sam Minkowicz
- Christopher Nolan
- Jesús Peñaloza
- Luke Shaheen
- Martin Spacek
- Nick Steinmetz
- Olivier Winter
- szapp
- ycanerol