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.
1. Install Miniconda (one‑time)
Section titled “1. Install Miniconda (one‑time)”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.
2. Create & activate an environment
Section titled “2. Create & activate an environment”Create an environment named particula with Python:
conda create -n particula python=3.12Activate it:
conda activate particulaYour prompt now starts with (particula)—everything you install will stay
inside this environment.
3. Add the conda‑forge channel (recommended)
Section titled “3. Add the conda‑forge channel (recommended)”Particula is published on the community‑maintained conda‑forge channel:
conda config --add channels conda-forgeconda config --set channel_priority strict4. Install Particula
Section titled “4. Install Particula”Install the core package:
conda install particulaNeed the tutorial extras (plots, progress‑bars, etc.)?
conda install matplotlib pandas pint tqdm5. Upgrade / Uninstall
Section titled “5. Upgrade / Uninstall”Upgrade Particula:
conda update particulaUninstall Particula:
conda remove particula6. Developing Particula from source
Section titled “6. Developing Particula from source”Working from a fork? After activating your particula environment, install
Particula editable + dev extras with pip (inside Conda it’s safe):
Install editable:
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.