Installation

raffalib-python requires Python ≥ 3.13 and is distributed as a local / editable install.

1. Clone the repository.

2. In the folder of your project, add the requirement:

uv add --editable [PATH_TO_LOCAL_REPO]

or, if you are not using uv:

python3 -m pip install --editable [PATH_TO_LOCAL_REPO]

Optional dependencies

The core install is intentionally light. The heavier integrations live behind optional-dependency extras, so you only pull in what you use:

Extra	Enables
pandas	the raffalib.pandas accessors
polars	the raffalib.polars accessors and join logging
bibliometrics	OpenAlex / Scopus helpers
crypto	KeePassXC / GnuPG helpers
db	SQLAlchemy view helpers
web	Selenium helpers
docs	build this documentation
dev	Ruff + pytest for development

Specify one or more extras in brackets:

uv add --editable "[PATH_TO_LOCAL_REPO][pandas,polars]"