Skip to content

Setup via conda

conda is a cross‑platform environment & package manager. Using an isolated Conda environment keeps Particula’s dependencies from colliding with other projects.

Download the latest Miniconda installer for your OS from
https://docs.conda.io/en/latest/miniconda.html and run it (accept the defaults). After installation, open a new terminal so the conda command is on your path.

Create an environment named particula with Python:

Terminal window
conda create -n particula python=3.12

Activate it:

Terminal window
conda activate particula

Your prompt now starts with (particula)—everything you install will stay inside this environment.

Section titled “3. Add the conda‑forge channel (recommended)”

Particula is published on the community‑maintained conda‑forge channel:

Terminal window
conda config --add channels conda-forge
conda config --set channel_priority strict

Install the core package:

Terminal window
conda install particula

Need the tutorial extras (plots, progress‑bars, etc.)?

Terminal window
conda install matplotlib pandas pint tqdm

Upgrade Particula:

Terminal window
conda update particula

Uninstall Particula:

Terminal window
conda remove particula

Working from a fork? After activating your particula environment, install Particula editable + dev extras with pip (inside Conda it’s safe):

Install editable:

Terminal window
pip install -e ".[dev,extra]"

If you want to contribute to Particula, see the Contributor Setup section for details on setting up a development environment and workflow.