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.0

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.0
File Size Uploaded Provenance Actions
stk-2026.10.11.0.tar.gz 11.6 MB Without provenance Details for stk-2026.10.11.0.tar.gz

Built distribution (wheel)

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

Total release size: 12.0 MB

Release files / stk-2026.10.11.0.tar.gz

Download URL stk-2026.10.11.0.tar.gz
Size 11.6 MB
Tags Source
SHA-256 checksum
How to use checksums
14f859fe128294874f273ae6ff0755df11d876ab1caa245e15bdc7dceb82dabb
BLAKE2b-256 checksum
How to use checksums
5435733eca03ba74f353c7ab06604c438fdca8762c7f23a4e8b03e66391df6aa
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.0-py3-none-any.whl

Download URL stk-2026.10.11.0-py3-none-any.whl
Size 403.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2da992d8146d78c5736dbc167a2be2443588641ef060fcbd14387be9a350a947
BLAKE2b-256 checksum
How to use checksums
0baaad2760e64853ce5728fb6a9e9492351622d4811c46ef0e872a3da492d16e
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.0

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.0 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