SpeechBrain is constantly evolving. New features, tutorials, and documentation will appear over time. SpeechBrain can be installed via PyPI to rapidly use the standard library. Moreover, a local installation can be used to run experiments and modify/customize the toolkit.
SpeechBrain supports both CPU and GPU computations. For most recipes, however, a GPU is necessary during training. Please note that CUDA must be properly installed to use GPUs.
We support pytorch >= 1.7 (https://pytorch.org/) and Python >= 3.7.
Once you have created your Python environment (see instructions below) you can simply type:
pip install speechbrain
Then you can then access SpeechBrain with:
import speechbrain as sb
Once you have created your Python environment (see instructions below) you can simply type:
git clone https://github.com/speechbrain/speechbrain.git
cd speechbrain
pip install -r requirements.txt
pip install --editable .
Then you can access SpeechBrain with:
import speechbrain as sb
Any modification made to the speechbrain package will be automatically interpreted as we installed it with the --editable flag.
Please, run the following script from the main folder to make sure your installation is working:
pytest tests
pytest --doctest-modules speechbrain
SpeechBrain supports Linux-based distributions and macOS. A solution for windows users can be found in this GitHub issue.
A good practice is to have different python environments for your different tools and toolkits, so they do not interfere with each other. This can be done either with Anaconda or venv.
Anaconda can be installed by simply following this tutorial. In practice, it is a matter of downloading the installation script and executing it.
Once Anaconda is installed, you can create a new environment with:
conda create --name speechbrain python=3.8
Then, activate it with:
conda activate speechbrain
Now, you can install all the needed packages!
More information on managing environments with Anaconda can be found in the documentation.
venv is even simpler. To create your environment:
python3 -m venv /path/to/new/virtual/speechbrain
And to activate it:
source /path/to/new/virtual/speechbrain/bin/activate
Now, you can install all the needed packages!
As SpeechBrain only relies on PyTorch, its GPU usage is also linked to it. Hence,
if PyTorch sees your GPUs, SpeechBrain will. Many functions can be called from the torch package to verify that your GPUs are detected:
import torch
torch.cuda.is_available()
torch.cuda.current_device()
torch.cuda.device(0)
torch.cuda.device_count()
torch.cuda.get_device_name(0)