chemsource
chemsource is a Python tool for exposomics research that classifies chemical compounds based on their exposure sources. It retrieves information from Wikipedia and PubMed, then uses large language models to classify chemicals into user-defined categories.
Quick Start
from chemsource import ChemSource
# Initialize with your OpenAI API key
chem = ChemSource(model_api_key="your_openai_api_key")
# Classify a compound
info, classification = chem.chemsource("aspirin")
print(f"Classification: {classification}")
Installation
Install from PyPI:
pip install chemsource
Documentation
For detailed documentation, tutorials, and API reference, visit:
The documentation includes:
- Installation and setup instructions
- Comprehensive API reference
- Usage examples and tutorials
- Configuration options
- Error handling guides
Requirements
- Python 3.8+
- OpenAI (or other LLM) API key (for classification)
- NCBI API key (optional, for enhanced PubMed access)
License
This project is licensed under the MIT License - see the LICENSE file for details.
Citation
If you use chemsource in your research, please cite: (Preprint coming soon)
Support
Note: chemsource uses OpenAI's API services which incur costs based on usage. New users receive $5 in free credits, sufficient for testing purposes. Other lower-cost endpoints are also available for classification (e.g. DeepSeek, gpt-oss, etc.). In particular, as of the creation of this package, Google Gemini provides a reasonable amount of free API credits.
1 maintainer
Metadata
1 maintainer
Release files for chemsource 1.1.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| chemsource-1.1.18.tar.gz | 18.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| chemsource-1.1.18-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 33.6 kB
Release files / chemsource-1.1.18.tar.gz
| Download URL | chemsource-1.1.18.tar.gz |
|---|---|
| Size | 18.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
30203f0956c822ac1cededce3451e7ac4bf960116ff75f89018b045ba1132016
|
|
BLAKE2b-256 checksum How to use checksums |
e5b8468bbfc3878316b6d7414a270d9b8fef8063154b96316a418f62c0283966
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / chemsource-1.1.18-py3-none-any.whl
| Download URL | chemsource-1.1.18-py3-none-any.whl |
|---|---|
| Size | 14.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
319b691e7d4573ff187bdc0e4cee51d127406447e579d33972f58cc53dd97590
|
|
BLAKE2b-256 checksum How to use checksums |
117ad5935ffc10b2ef4f2cb3ca9086c5d5ca6f53e7b314f4f6946ba4515ffb0b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
