PubChemPy
PubChemPy provides a way to interact with PubChem in Python. It allows chemical searches by name, substructure and similarity, chemical standardization, conversion between chemical file formats, depiction and retrieval of chemical properties.
Installation
Install PubChemPy with pip:
pip install pubchempy
Or with conda:
conda install -c conda-forge pubchempy
For detailed instructions, see the installation guide.
Example usage
Retrieve a compound by its PubChem Compound Identifier (CID) and print its SMILES and IUPAC name:
>>> import pubchempy as pcp
>>> comp = pcp.Compound.from_cid(1423)
>>> print(comp.smiles)
CCCCCCCNC1CCCC1CCCCCCC(=O)O
>>> print(comp.iupac_name)
7-[2-(heptylamino)cyclopentyl]heptanoic acid
Search compounds by name and print the SMILES and molecular weight of the first result:
>>> results = pcp.get_compounds("Aspirin", "name")
>>> print(results[0].smiles)
CC(=O)OC1=CC=CC=C1C(=O)O
>>> print(results[0].molecular_weight)
180.16
Documentation
Full documentation is available at https://docs.pubchempy.org.
This includes a step-by-step guide on how to use PubChemPy, as well as a complete API reference.
Contributing
- Feature ideas and bug reports are welcome on the Issue Tracker.
- Fork the source code on GitHub, make changes and file a pull request.
License
PubChemPy is licensed under the MIT license.
Metadata
Release files for PubChemPy 1.0.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pubchempy-1.0.5.tar.gz | 26.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pubchempy-1.0.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.2 kB
Release files / pubchempy-1.0.5.tar.gz
| Download URL | pubchempy-1.0.5.tar.gz |
|---|---|
| Size | 26.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
08f0b2a82a5caa5d61e14935d655da554602d7b5686fe661ab584c882ffff623
|
|
BLAKE2b-256 checksum How to use checksums |
30a11b63d717a315b5fdc281e312bd02e9069e22ed8aa63a56d79f8dae95a1f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2025.
Transparency logRelease files / pubchempy-1.0.5-py3-none-any.whl
| Download URL | pubchempy-1.0.5-py3-none-any.whl |
|---|---|
| Size | 21.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e936cfed31fa194042ad463be3c803dde5b12ef2f795caf336e3114127c34fa0
|
|
BLAKE2b-256 checksum How to use checksums |
6be32c887645f21b94d992a16775bcf81cdf6dcc36cf1606782cb2a3c86e9a35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2025.
Transparency log