Installation & Setup

Caer supports an installation of Python 3.6 above, available on Windows, MacOS and Linux systems.

Version check

To see whether caer is already installed or to check if an install has worked, run the following in a Python shell or Jupyter notebook:

>> import caer
>> print(caer.__version__)

or, from the command line:

python -c "import caer; print(caer.__version__)"

(Try python3 if python is unsuccessful.)

You’ll see the version number if caer is installed and an error message otherwise.



Do not use the commands sudo and pip together as pip may overwrite critical system libraries which may require you to reinstall your operating system.

Bleeding Edge

If a bug fix was made in the repo and you can’t wait till a new release is made, you can install the bleeding edge version of caer using:

pip install git+

From Source

If you plan to develop caer yourself, or want to be on the cutting edge, you can use an editable install:

First, uninstall any existing installations:

pip uninstall -y caer

Clone the repo:

git clone
cd caer
pip install -e . # Do this once to add the package to the Python Path

To update the installation:

git pull  # Grabs the latest source
pip install -e . # Reinstalls Caer

System package managers

Using a package manager (yum, apt-get, etc.) to install caer or other Python packages is not your best option:

  • You’re likely to get an older version.

  • You’ll probably want to make updates and add new packages outside of the package manager, leaving you with the same kind ofdependency conflicts you see when using pip without a virtual environment.

  • There’s an added risk because operating systems use Python, so if you make system-wide Python changes (installing as root or using sudo), you can break the operating system.

Read the Docs v: latest
On Read the Docs
Project Home

Free document hosting provided by Read the Docs.