Installing PyCatSim

If you know what you are doing, you may install PyCatSim in any suitable Python environment, with a Python version >=3.12.

However, we have not and cannot possibly, try every situation.

If you are new to Python, we recommend the use of Anaconda (or its minimal version Miniconda), to set up such an environment. Then you may install PyCatSim via pip.

Installing Anaconda or Miniconda

To install Anaconda or Miniconda on your platform, follow the instructions from this page.

Creating a new conda environment

As of June 2025, we recommend Python 3.12. Create an environment via the command line (e.g. Terminal app in MacOS):

conda create -n cat python=3.12

To view a list of available environments:

conda env list

To activate the new environment:

conda activate cat

To view the list of packages in your environment:

conda list

To remove the environment:

conda remove --name cat --all

More information about managing conda environments can be found here.

Installing PyCatSim

Once the pyleo environment is activated, simply run:

pip install pyCatSim

This will install the latest official release, which you can view here. To install the latest version, which contains the most up-to-date features, you can install directly from the GitHub source:

pip install git+https://github.com/khider/pyCatSim.git

This version may contain bugs not caught by our continuous integration test suite; if so, please report them via github issues

If you would like to use Spyder for code development:

conda install spyder

If you intend on using PyCatSim within a Jupyter Notebook, we recommend using ipykernel.

conda install ipykernel
python -m ipykernel install --user --name=cat

The first line will install ipykernel and its dependencies, including IPython, Jupyter, etc. The second line will make sure the pyleo environment is visible to Jupyter (see this page for context)