Installation¶

Requirements¶

Python 3.10, 3.11, 3.12, 3.13, or 3.14.

User installation¶

pip¶

pip install mendeleev

With visualization support (bokeh, plotly, seaborn):

pip install mendeleev[vis]

conda-forge¶

conda install conda-forge::mendeleev

Latest from source¶

pip install git+https://github.com/lmmentel/mendeleev.git

Development setup¶

For contributors who want to run tests, build docs, or modify the code:

git clone https://github.com/lmmentel/mendeleev.git
cd mendeleev

# Install core dependencies
poetry install

# With visualization extras
poetry install --with vis

# Install pre-commit hooks (ruff lint + format)
pre-commit install

# Run tests
poetry run pytest

# Build docs (one-time: install docs deps, then build)
poetry install --with docs
cd docs
poetry run make html

See Contributing to mendeleev for full contribution guidelines.