2  Setting up the repository

Before starting the course, we need to install the course materials and all dependency packages (such as SpikeInerface) onto your machine.

To do this we will create an isolated environment in which to install packages, either using uv (recommended) or conda.

2.1 Download the repository

First, clone the course repository with git:

git clone https://github.com/neuroinformatics-unit/course-ephys-osss.git
cd course-ephys-osss

If you don’t have git installed, you can instead download the repository as a ZIP file from the GitHub page (click the green Code button, then Download ZIP) and unzip it.

2.2 Create the environment

uv

uv is a fast Python package and environment manager. If you don’t have it yet, follow the installation instructions.

From inside the course-ephys-osss folder, create a virtual environment and install the project (along with all its dependencies):

uv venv
uv pip install -e .

uv venv creates a .venv folder in the repository. To activate it:

# macOS / Linux
source .venv/bin/activate

# Windows (PowerShell)
.venv\Scripts\Activate.ps1

conda

conda is a widely used Python environment and package manager. If you don’t have it yet, we recommend installing Miniconda.

From inside the course-ephys-osss folder, create and activate a new environment:

conda create -n course-ephys python=3.12 -y
conda activate course-ephys

Then install the project (along with all its dependencies) using pip:

pip install -e .

2.3 Check the installation

With the environment active, check that the package imports correctly:

python -c "import course_ephys_osss; print('Setup complete!')"

If this runs without error, you’re ready to start the course.