OpenFF Pablo

Latest release
main Branch

New implementation of OpenFF's Topology.from_pdb

OpenFF Pablo is bound by a Code of Conduct.

Installation

This is a pre-release of Pablo and is not yet published in any package manager. You can install it by managing your own Conda environment and installing it manually.

Here we describe dependency and environment management with Micromamba, but other Conda-compatible package managers such as Conda and Mamba work the same way - just change the name of the executable.

Install Pablo and its dependencies into the current environment:

# Install dependencies and pip into current environment
micromamba install -c conda-forge pip 'python>=3.12' 'openff-toolkit-base>=0.17.1' rustworkx rdkit openmm pyxdg gemmi
# Install Pablo's latest release into current environment via pip
pip install git+https://github.com/openforcefield/[email protected]

Development build

Clone the repository:

git clone https://github.com/openforcefield/openff-pablo

Create a virtual environment:

micromamba create --name pablo-dev

Install the development and documentation dependencies:

micromamba env update -n pablo-dev --file openff-pablo/devtools/conda-envs/test_env.yaml
micromamba env update -n pablo-dev --file openff-pablo/devtools/conda-envs/docs_env.yaml

Install Pablo in editable mode:

micromamba run -n pablo-dev pip install -e openff-pablo

Then activate the environment to run commands in it:

micromamba activate pablo-dev

Or use micromamba run -n pablo-dev. If you want to update your dependencies, rebuild the environment from scratch.

Copyright

The OpenFF Pablo source code is hosted at https://github.com/openforcefield/openff-pablo and is available to all under the MIT license (see the file LICENSE).

Copyright (c) 2025, Open Force Field Initiative

Acknowledgements

Project based on the OpenFF Cookiecutter version 0.1.