Skip to main content

A SEAMM plug-in for xTB

Project description

SEAMM xTB Plug-in

GitHub pull requests Build Status Code Coverage Code Quality Documentation Status PyPi VERSION

A SEAMM plug-in for the xTB family of extended tight-binding methods from the Grimme group.

Features

  • Single-point energies, geometry optimizations, and harmonic vibrational frequencies for molecular (non-periodic) systems.

  • The full set of xTB Hamiltonians and the GFN-FF force field:

    • GFN2-xTB (default) – self-consistent, multipole electrostatics, density-dependent dispersion. Recommended for general use.

    • GFN1-xTB – earlier self-consistent method.

    • GFN0-xTB – non-self-consistent, useful for robust screening.

    • GFN-FF – generic force field, automatically parameterized.

  • Implicit solvation with all three xTB-supported models:

    • ALPB – analytical linearized Poisson-Boltzmann (Ehlert et al., J. Chem. Theory Comput. 2021, 17, 4250).

    • GBSA – generalized-Born model.

    • CPCM-X – conductor-like polarizable continuum (Stahn et al., J. Phys. Chem. A 2023, 127, 7036).

    with the standard xTB solvent list (water, methanol, DMSO, acetonitrile, etc.).

  • Net charge and spin multiplicity are read from the configuration, so the same flowchart works unchanged across O2, triplet O2, and O2+ – a single loop can scan a list of systems with different charge/spin states.

  • Optimization with all eight xTB convergence levels (crude through extreme) and flexible structure handling: overwrite the current configuration in place, store the optimized structure as a new configuration, store it in a new system, or discard.

  • Vibrational analysis using xTB’s analytic Hessian, with the optimize-then-Hessian (--ohess) workflow recommended by xTB (or --hess alone if the geometry is already at a stationary point). Thermochemistry quantities (ZPE, H(T), T*S, S, G(T), total free energy) are reported in chemist-friendly units of kJ/mol and J/mol/K, not Eh.

  • Tabulated results in the local step.out and storage in the SEAMM property database using the standard <name>#xTB#{model} property-naming convention, so downstream plug-ins (Thermochemistry, Reaction Path, …) can pick up the values.

  • Automatic citation tracking. The principal xTB program reference, the active GFN method reference, the DFT-D4 dispersion references (for GFN2-xTB), and the implicit-solvation reference are all added to the run’s reference list automatically.

  • Automatic installation of the xtb executable into a dedicated seamm-xtb conda environment via the standard SEAMM Installer.

Acknowledgements

This package was created with the molssi-seamm/cookiecutter-seamm-plugin tool, which is based on the excellent Cookiecutter.

Developed by the Molecular Sciences Software Institute (MolSSI), which receives funding from the National Science Foundation under award CHE-2136142.

History

2026.5.2: Plug-in created using the SEAMM plug-in cookiecutter.

2026.5.12: Initial working version
  • Support for Energy, Optimization, and Frequencies

  • GFN0-xTB, GFN1-xTB, GFN2-xTB (the default), and GFN-FF supported

  • ALPB, GBSA, or CPCM-X implicit solvation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xtb_step-2026.5.12.tar.gz (368.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xtb_step-2026.5.12-py2.py3-none-any.whl (52.4 kB view details)

Uploaded Python 2Python 3

File details

Details for the file xtb_step-2026.5.12.tar.gz.

File metadata

  • Download URL: xtb_step-2026.5.12.tar.gz
  • Upload date:
  • Size: 368.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for xtb_step-2026.5.12.tar.gz
Algorithm Hash digest
SHA256 66693273b553503cc8246b6286a004a3460902b798287117f6bb27d2ab514733
MD5 941d0b4e4b1036cdec4383003996b491
BLAKE2b-256 5af0e7c0fbd12b3fb63e5c19062033a5209371db5e72415d3dff88da1ea4d909

See more details on using hashes here.

File details

Details for the file xtb_step-2026.5.12-py2.py3-none-any.whl.

File metadata

  • Download URL: xtb_step-2026.5.12-py2.py3-none-any.whl
  • Upload date:
  • Size: 52.4 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for xtb_step-2026.5.12-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 7158cc5d922c805773925b0ec293a0664f99116fdaa53eec3117249b5b4d905f
MD5 2c409518dd02efde980f2705cbed2334
BLAKE2b-256 a45471baf6fe89779be00a38d72257daa95e13c7cbb165a467833f79e112e36f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page