Skip to main content
maintainers:

lukasturcani, andrewtarzia

documentation:

https://stk.readthedocs.io

discord:

https://discord.gg/zbCUzuxe2B

docs/source/_static/stk.png
https://github.com/lukasturcani/stk/actions/workflows/tests.yml/badge.svg?branch=master https://readthedocs.org/projects/stk/badge/?version=latest

Overview

stk is a Python library which allows construction and manipulation of complex molecules, as well as automatic molecular design, and the creation of molecular, and molecular property, databases. The documentation of stk is available on https://stk.readthedocs.io and the project’s Discord server can be joined through https://discord.gg/zbCUzuxe2B.

Installation

To get stk, you can install it with pip:

pip install stk

If you would like to get updated when a new release of stk comes out, which happens pretty regularly, click on the watch button on the top right corner of the GitHub page. Then select Releases only from the dropdown menu.

You can see the latest releases here:

https://github.com/lukasturcani/stk/releases

There will be a corresponding release on pip for each release on GitHub, and you can update your stk with:

pip install stk --upgrade

Warning:

SMILES strings generated with stk version v2025.07.17.0 or sooner (using rdkit version 2024.9.1 or sooner) will be different than newer versions due to a change in handling the valence of organic atoms bound to metals. Details can be found in the rdkit release notes 2025_03_1. No changes occur in stk construction. An example change in SMILES: CCCO->[Fe+2] becomes CCC[OH]->[Fe+2].

Developer Setup

  1. Install just.

  2. Install uv.

  3. In the source directory, run:

just setup
  1. Setup the MongoDB container (make sure docker is installed):

just mongo
  1. Run code checks:

just check

How To Cite

If you use stk please cite

https://github.com/lukasturcani/stk

and

https://aip.scitation.org/doi/10.1063/5.0049708

Publications

about stk

using stk

Acknowledgements

I began developing this code when I was working in the Jelfs group, http://www.jelfs-group.org/, whose members often provide me with very valuable feedback, which I gratefully acknowledge.

Metadata

Release files for stk 2026.10.11.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for stk 2026.10.11.1
File Size Uploaded Provenance Actions
stk-2026.10.11.1.tar.gz 11.6 MB Without provenance Details for stk-2026.10.11.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for stk 2026.10.11.1
File Interpreter ABI Platform Actions
stk-2026.10.11.1-py3-none-any.whl Python 3 none any Details for stk-2026.10.11.1-py3-none-any.whl

Total release size: 12.0 MB

Release files / stk-2026.10.11.1.tar.gz

Download URL stk-2026.10.11.1.tar.gz
Size 11.6 MB
Tags Source
SHA-256 checksum
How to use checksums
fd59de01ba0c497ed16e3db4b99343ba94500cefe0b1654052702f52e69545a4
BLAKE2b-256 checksum
How to use checksums
0036d5323d53950e377d4839b18b2c8c5ca9eaaeac4509a0ff46cd2d7ef8a9d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / stk-2026.10.11.1-py3-none-any.whl

Download URL stk-2026.10.11.1-py3-none-any.whl
Size 403.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c4b212c43b21bafbaa3d3bc2767a021a1d998c7dd1d785ca136b8b3fdb329df0
BLAKE2b-256 checksum
How to use checksums
e078a9f5f0250ddadc15af991f940819da3448191f737a9bdbf6ebed5f2ca2a8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for stk 2026.10.11.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2026.10.11.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page