Skip to main content

PubChemPy

PyPI Version Conda Version License DOI Tests Docs

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)

Source distribution for PubChemPy 1.0.5
File Size Uploaded
pubchempy-1.0.5.tar.gz 26.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for PubChemPy 1.0.5
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

1.0.5 This release

2 release files

1.0.4

1 release file

1.0.3

1 release file

1.0.2

1 release file

1.0.1

1 release file

1.0

1 release file

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