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.13.tar.gz (387.0 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.13-py2.py3-none-any.whl (52.4 kB view details)

Uploaded Python 2Python 3

File details

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

File metadata

  • Download URL: xtb_step-2026.5.13.tar.gz
  • Upload date:
  • Size: 387.0 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.13.tar.gz
Algorithm Hash digest
SHA256 de98ae6629a355e0162385ef71300010485c95ae5961036fec61003e09aaf707
MD5 3531b6b2c06e2d11c84e9030de548f48
BLAKE2b-256 38ac8aa78ca3c168886901b7f8bae3caf87d48f24c2bbd48dc75d9b40a153c74

See more details on using hashes here.

File details

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

File metadata

  • Download URL: xtb_step-2026.5.13-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.13-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 553865108bfe6f18330f3cd78722b310dab72089dfce0202cc1299bb624bf1a3
MD5 61f6af6b1b86e0fd99985851b85bca26
BLAKE2b-256 cd6868491da6f2e5ae76a65a2a6faf5b0d7319608f807ae2b9d67818b802edc7

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