Overview
chematic provides a shared Rust chemistry core for native applications, Python notebooks and browser tools. It turns molecular representations into structures, calculated descriptors and fingerprints, with similarity and substructure operations for exploring compound collections. The source is available under MIT OR Apache-2.0. The optional chematic-mcp component connects chemistry tools to MCP clients; the library itself is not an autonomous research agent.
Compatibility is defined per operation and binding. The RDKit-style layer covers selected APIs, and default Morgan fingerprints are not bit-identical to RDKit. 3D generation, pKa/ADMET screening, IUPAC naming, Markush/polymer expansion and rich CDXML editing remain experimental or bounded. Calculated outputs do not establish experimental efficacy or safety. Results should be assessed on the intended chemistry and exact software artifact.
Key Features
- Parse and write supported SMILES/SMARTS and common MOL/SDF molecular records.
- Calculate descriptors and fingerprints; perform Tanimoto similarity and substructure searches.
- Use documented Rust, Python, Node and WebAssembly interfaces backed by the shared Rust core.
- Run supported browser chemistry locally in WebAssembly without a chematic backend.
- Expose local chemistry tools through chematic-mcp using stdio or optional self-hosted Streamable HTTP.
- Return explicit failures for unsupported cases; canonical_smiles() is not a universal identity key.
Use Cases
- Explore compound collections in a Python notebook and prepare descriptor or fingerprint features for downstream machine learning.
- Embed molecular parsing, property cards and similarity exploration in a browser application.
- Let an MCP client request documented chemistry operations, while keeping experimental screening outputs subject to domain review.
How to Use
The documentation offers pip install chematic for supported Python wheel platforms and npm install @kent-tokyo/chematic for browser integration. A minimal Python example is:
import chematic
mol = chematic.from_smiles("CC(=O)Oc1ccccc1C(=O)O")
print(mol.mw, mol.logp, mol.tpsa)
Browser integrations initialize the WASM module before parsing molecules and release handles afterward. Node requires explicit WASM byte loading. For MCP, configure the client to launch chematic-mcp with an empty argument list for stdio; select the package version using its release documentation. The HTTP option is self-hosted and supplies no authentication or OAuth. The optional name_to_smiles tool sends names to PubChem. See the installation guide and MCP README for setup and limits.
Sources and verification
This entry describes capabilities documented by the linked project sources. Catalog edits are not evidence of a successful run, compatibility test or scientific performance evaluation.
Read the editorial and verification policy