cdxml-toolkit 0.5.0__tar.gz

cdxml_toolkit-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hiu Fung Kevin Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cdxml_toolkit-0.5.0/NOTICE.md

@@ -0,0 +1,37 @@
+# Third-Party Notices
+
+This project includes data and code derived from the following sources.
+
+## ChemScanner (data source)
+
+The files `chemscanner_abbreviations.json` and `superatom_data.json` contain
+chemical abbreviation-to-SMILES mappings derived from data files in the
+[ChemScanner](https://github.com/ComPlat/chem_scanner) project, which is
+licensed under AGPL-3.0.
+
+The original data was extracted from ChemScanner's `abbreviations.yaml`,
+`solvents.yaml`, and `superatom.txt` configuration files. The extraction
+process involved:
+- Parsing the original YAML/TXT files
+- Validating all SMILES strings with RDKit
+- Canonicalizing SMILES to a standard form
+- Deduplicating entries by canonical SMILES
+- Reorganizing into a different JSON schema with alias support
+
+The resulting JSON files contain factual chemical information (abbreviation
+labels mapped to their corresponding SMILES representations). Chemical
+abbreviation-to-structure mappings are scientific facts — "OTs" represents
+a tosylate group regardless of the source from which it is documented.
+
+## RDKit Built-in Abbreviations (runtime data source)
+
+At runtime, `superatom_table.py` supplements its JSON-backed lookup table
+with abbreviation data from RDKit's `rdAbbreviations.GetDefaultAbbreviations()`
+(approximately 40 entries). RDKit is licensed under the
+[BSD 3-Clause License](https://github.com/rdkit/rdkit/blob/master/license.txt).
+
+## Reagent Database
+
+The file `reagent_abbreviations.json` is an original curated database of
+approximately 172 reagent entries commonly used in medicinal chemistry,
+compiled by the project author. It is licensed under MIT as part of this project.

cdxml_toolkit-0.5.0/PKG-INFO

@@ -0,0 +1,318 @@
+Metadata-Version: 2.4
+Name: cdxml-toolkit
+Version: 0.5.0
+Summary: Python toolkit for ChemDraw CDXML reaction scheme processing, layout, and rendering.
+Author: Hiu Fung Kevin Lee
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/leehiufung911/cdxml-toolkit
+Project-URL: Repository, https://github.com/leehiufung911/cdxml-toolkit
+Project-URL: Issues, https://github.com/leehiufung911/cdxml-toolkit/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Chemistry
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE.md
+Requires-Dist: lxml>=4.6
+Provides-Extra: rdkit
+Requires-Dist: rdkit>=2023.03; extra == "rdkit"
+Provides-Extra: chemdraw
+Requires-Dist: pywin32>=300; extra == "chemdraw"
+Provides-Extra: image
+Requires-Dist: opencv-python>=4.5; extra == "image"
+Requires-Dist: Pillow>=9.0; extra == "image"
+Provides-Extra: office
+Requires-Dist: python-pptx>=0.6; extra == "office"
+Requires-Dist: python-docx>=0.8; extra == "office"
+Requires-Dist: olefile>=0.46; extra == "office"
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=5.4; extra == "yaml"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Requires-Dist: pyyaml>=5.4; extra == "mcp"
+Provides-Extra: analysis
+Requires-Dist: pdfplumber>=0.7; extra == "analysis"
+Provides-Extra: chemscript
+Requires-Dist: pythonnet>=3.0; extra == "chemscript"
+Provides-Extra: decimer
+Requires-Dist: tensorflow>=2.16; extra == "decimer"
+Requires-Dist: decimer>=2.6; extra == "decimer"
+Requires-Dist: pymupdf>=1.20; extra == "decimer"
+Provides-Extra: ocr
+Requires-Dist: pytesseract>=0.3; extra == "ocr"
+Provides-Extra: opsin
+Requires-Dist: py2opsin>=1.0; extra == "opsin"
+Provides-Extra: all
+Requires-Dist: cdxml-toolkit[analysis,chemdraw,chemscript,image,mcp,office,opsin,rdkit,yaml]; extra == "all"
+Provides-Extra: full
+Requires-Dist: cdxml-toolkit[all,decimer,ocr]; extra == "full"
+Provides-Extra: dev
+Requires-Dist: cdxml-toolkit[all]; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# cdxml-toolkit
+
+Chemistry office automation toolkit with MCP (Model Context Protocol) server. Lets LLM agents draw reaction schemes, parse ELN exports, analyze LCMS data, and produce publication-ready ChemDraw (CDXML) output.
+
+The goal: any chemist with a consumer GPU can run a local LLM agent that helps with routine chemistry office tasks. The toolkit provides 15 grounded, validated chemistry tools that LLMs call via MCP — the agent reasons about chemistry while the tools handle SMILES resolution, 2D coordinate generation, and CDXML layout.
+
+> Built and tested with Claude Code (Opus 4.6). I directed the design and architecture; Claude did the implementation. I'm a PhD organic chemist, not a programmer — this project wouldn't exist without Claude Code, and I thank Anthropic. 
+
+## Quick start: MCP server
+
+The primary interface is the MCP server. Connect it to any MCP-compatible agent (Claude Desktop, opencode, qwen-agent, etc.) and just chat naturally: "Draw deucravacitinib", "Help me complete my lab book", "Extract structures from this image".
+
+### Claude Desktop
+
+Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac):
+
+```json
+{
+  "mcpServers": {
+    "cdxml-toolkit": {
+      "command": "python",
+      "args": ["-m", "cdxml_toolkit.mcp_server"]
+    }
+  }
+}
+```
+
+### opencode (for OpenRouter / local models)
+
+Create `opencode.json`:
+
+```json
+{
+  "provider": {
+    "openrouter": {
+      "models": { "qwen/qwen3.5-27b": {} }
+    }
+  },
+  "mcp": {
+    "cdxml-toolkit": {
+      "type": "local",
+      "command": ["python", "-m", "cdxml_toolkit.mcp_server"],
+      "enabled": true,
+      "timeout": 120000
+    }
+  }
+}
+```
+
+### Verify it works
+
+```
+> Use cdxml-toolkit. Resolve "aspirin", then draw it.
+```
+
+Expected: 2 tool calls (resolve_name, draw_molecule), produces an aspirin CDXML file.
+
+## MCP tools (15)
+
+### Chemistry resolution
+| Tool | Description |
+|------|-------------|
+| `resolve_name` | Name/abbreviation/CAS/formula to rich molecule JSON (5-tier: reagent DB, condensed formula, ChemScript, OPSIN, PubChem) |
+| `modify_molecule` | 6 operations: analyze, name_surgery, smarts, set_smiles, set_name, reaction. 162 named reaction templates. Returns MCS-based structural diffs. |
+
+### Structure rendering
+| Tool | Description |
+|------|-------------|
+| `draw_molecule` | Single molecule to CDXML |
+| `render_scheme` | YAML/compact text/reaction JSON to publication-ready CDXML. Forgiving parser handles common LLM YAML mistakes. |
+
+### Perception (reading existing chemistry)
+| Tool | Description |
+|------|-------------|
+| `parse_reaction` | ELN exports (CDXML/CDX/CSV/RXN) to semantic JSON with species, roles, SMILES, equivalents |
+| `summarize_reaction` | Context-efficient view of reaction JSON (select only the fields you need) |
+| `extract_structures_from_image` | Image to SMILES + confidence scores via DECIMER neural network |
+| `parse_scheme` | CDXML scheme to structured species/steps/topology JSON |
+
+### Analysis
+| Tool | Description |
+|------|-------------|
+| `parse_analysis_file` | LCMS (Waters/manual) or NMR (MestReNova) PDF to structured peak data |
+| `format_lab_entry` | Structured entry dicts to formatted lab book text. Re-reads LCMS PDFs for exact numbers. |
+
+### Office integration
+| Tool | Description |
+|------|-------------|
+| `extract_cdxml_from_office` | Pull embedded ChemDraw OLE objects from PPTX/DOCX |
+| `embed_cdxml_in_office` | Inject CDXML as editable ChemDraw OLE into PPTX/DOCX |
+| `convert_cdx_cdxml` | Bidirectional CDX/CDXML conversion |
+| `search_compound` | Find a molecule across experiment directories by SMILES similarity |
+| `render_to_png` | CDXML to PNG via ChemDraw COM |
+
+## Design principles
+
+**Never trust LLM-generated SMILES.** The agent always goes through `resolve_name` to get grounded SMILES from databases. Direct SMILES generation is the #1 source of chemistry hallucination.
+
+**Verify every transformation.** `modify_molecule` returns aligned IUPAC name diffs and MCS-based molecular diffs after every edit. The agent can confirm the transformation is correct.
+
+**Never flood the agent.** Large outputs (CDXML, JSON) always write to files and return `{ok: true, output_path: "...", size: 23456}`. The agent never gets 30KB of XML in its context window.
+
+**Forgiving inputs.** The YAML parser accepts 9+ common LLM mistakes (inline structures, `substrates` as alias for `structures`, text as string not list, bare SMILES, `above_arrow` as list/string). Input parameters accept bare SMILES strings, stringified JSON arrays, and fuzzy operation names.
+
+**Actionable errors.** Every error tells the agent what to do instead: "Did you mean: BOC_deprotection?", not "KeyError".
+
+**Progressive discovery.** Call any tool with no arguments to get usage examples and schema reference.
+
+## Installation
+
+**Prerequisites:** Windows with ChemDraw (ChemOffice 2015+) and ChemScript installed.
+
+```bash
+# From GitHub — recommended install (includes RDKit, MCP server, ChemDraw COM,
+# Office support, PDF parsing, image processing, and ChemScript bridge)
+pip install "cdxml-toolkit[all] @ git+https://github.com/leehiufung911/cdxml-toolkit.git@main"
+
+# With DECIMER neural image extraction (extract_structures_from_image)
+pip install "cdxml-toolkit[all,decimer] @ git+https://github.com/leehiufung911/cdxml-toolkit.git@main"
+
+# Development (editable install)
+git clone https://github.com/leehiufung911/cdxml-toolkit.git
+cd cdxml-toolkit
+pip install -e ".[dev]"
+```
+
+**Required:** `lxml>=4.6`. **Recommended:** `rdkit>=2023.03` (needed for scheme rendering).
+
+### Extras
+
+| Extra | What it includes | Notes |
+|-------|-----------------|-------|
+| `[all]` | RDKit, pywin32, image, Office, YAML, PDF analysis, MCP server, pythonnet, py2opsin | **Use this.** Everything most users need. |
+| `[decimer]` | TensorFlow, DECIMER, PyMuPDF | Neural image-to-SMILES. Adds ~1 GB. |
+| `[full]` | `[all]` + `[decimer]` + `[ocr]` | Everything pip-installable. |
+| `[rdkit]` | RDKit only | Minimal install for scripting. |
+| `[mcp]` | MCP server + PyYAML | MCP server only (no RDKit/Office). |
+| `[dev]` | `[all]` + pytest | For running the test suite. |
+
+### Name resolution tiers
+
+`resolve_name` tries 5 tiers in order. The first tier to return a valid SMILES wins:
+
+| Tier | Source | Deps | Coverage |
+|------|--------|------|----------|
+| 1 | Curated reagent DB (186 entries) | None | Common reagents, catalysts, solvents |
+| 2 | Condensed formula parser | RDKit | Shorthand like PhB(OH)2, Et3N, CF3 |
+| 3 | **ChemScript** (preferred) | ChemDraw + 32-bit Python | Full IUPAC names, any drawable structure |
+| 4 | **OPSIN** (bundled fallback) | py2opsin + bundled JRE | Systematic IUPAC names, offline |
+| 5 | PubChem | Network | CAS numbers, trade names, everything else |
+
+ChemScript (Tier 3) is preferred because it handles the widest range of names and integrates with ChemDraw's structure engine. OPSIN (Tier 4) is a fully offline fallback that works out of the box — a JRE is bundled with the package, no Java install needed. If neither is available, PubChem provides a network-based last resort.
+
+### System dependencies (not pip-installable)
+
+| Dependency | Required for | Setup |
+|-----------|-------------|-------|
+| **ChemDraw** (ChemOffice 2015+) | CDX conversion, PNG rendering | Must be **closed** before running COM tools. |
+| **ChemScript .NET** | Name resolution Tier 3 (preferred, not required) | Comes with ChemOffice. See setup below. |
+| **Microsoft Office** | OLE embedding into PPTX/DOCX | Optional. Only needed for `embed_cdxml_in_office`. |
+
+### ChemScript setup (optional but recommended)
+
+ChemScript gives the best IUPAC name resolution but requires a 32-bit Python environment because the ChemScript .NET DLL is 32-bit. If you skip this, OPSIN handles IUPAC names as a fallback.
+
+```bash
+# 1. Create 32-bit Python env
+set CONDA_SUBDIR=win-32 && conda create -n chemscript32 python=3.10 -y
+
+# 2. Install pythonnet in the 32-bit env
+C:\Users\%USERNAME%\miniconda3\envs\chemscript32\python.exe -m pip install pythonnet
+
+# 3. Auto-detect ChemDraw and save config
+cdxml-convert --configure
+```
+
+Step 3 scans for ChemDraw (2015/2016/PerkinElmer paths) and writes `~/.chemscript_config.json`. If your ChemDraw is in a non-standard location, edit the config manually:
+
+```json
+{
+  "python32": "C:\\Users\\YOU\\miniconda3\\envs\\chemscript32\\python.exe",
+  "dll_dir": "C:\\Program Files (x86)\\PerkinElmerInformatics\\ChemOffice2016\\ChemScript\\Lib\\Net",
+  "assembly": "CambridgeSoft.ChemScript16"
+}
+```
+
+## CLI tools
+
+All tools are also available as command-line scripts:
+
+| Command | Description |
+|---------|-------------|
+| `cdxml-mcp` | MCP server (primary interface) |
+| `cdxml-parse` | Parse reaction files to JSON |
+| `cdxml-render` | Render JSON/YAML/compact text to CDXML |
+| `cdxml-convert` | CDX/CDXML bidirectional conversion |
+| `cdxml-image` | CDXML to PNG/SVG (ChemDraw COM) |
+| `cdxml-merge` | Merge multiple reaction schemes |
+| `cdxml-layout` | Clean up reaction layout (pure Python) |
+| `cdxml-ole` | Embed CDXML as editable OLE in PPTX/DOCX |
+| `cdxml-lcms` | Parse LCMS PDF reports |
+| `cdxml-nmr` | Extract NMR data from MestReNova PDFs |
+| `cdxml-format-entry` | Format lab book entries |
+| `cdxml-discover` | Discover experiment files in a directory |
+
+## Scheme DSL
+
+The renderer accepts three input formats:
+
+**YAML** (what agents typically write):
+```yaml
+layout: sequential
+structures:
+  SM:
+    smiles: "Brc1ncnc2sccc12"
+  Product:
+    smiles: "c1nc(N2CCOCC2)c2ccsc2n1"
+steps:
+  - substrates: [SM]
+    products: [Product]
+    above_arrow:
+      structures: [Morph]
+    below_arrow:
+      text: ["Pd2(dba)3", "BINAP", "Cs2CO3", "Dioxane, 105 C"]
+```
+
+**Compact text** ("Mermaid for reactions"):
+```
+SM: {Brc1ncnc2sccc12}
+SM --> Product{c1nc(N2CCOCC2)c2ccsc2n1}
+  above: Morph{C1COCCN1}
+  below: "Pd2(dba)3", "BINAP", "Cs2CO3"
+```
+
+**Reaction JSON** (from parse_reaction):
+```bash
+cdxml-render --from-json reaction.json -o scheme.cdxml
+```
+
+## Running tests
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+[MIT](LICENSE)
+
+## Attribution
+
+See [NOTICE.md](NOTICE.md) for third-party data attribution (ChemScanner, RDKit).
+
+## Author
+
+Hiu Fung Kevin Lee ([@leehiufung911](https://github.com/leehiufung911))

cdxml_toolkit-0.5.0/README.md

@@ -0,0 +1,257 @@
+# cdxml-toolkit
+
+Chemistry office automation toolkit with MCP (Model Context Protocol) server. Lets LLM agents draw reaction schemes, parse ELN exports, analyze LCMS data, and produce publication-ready ChemDraw (CDXML) output.
+
+The goal: any chemist with a consumer GPU can run a local LLM agent that helps with routine chemistry office tasks. The toolkit provides 15 grounded, validated chemistry tools that LLMs call via MCP — the agent reasons about chemistry while the tools handle SMILES resolution, 2D coordinate generation, and CDXML layout.
+
+> Built and tested with Claude Code (Opus 4.6). I directed the design and architecture; Claude did the implementation. I'm a PhD organic chemist, not a programmer — this project wouldn't exist without Claude Code, and I thank Anthropic. 
+
+## Quick start: MCP server
+
+The primary interface is the MCP server. Connect it to any MCP-compatible agent (Claude Desktop, opencode, qwen-agent, etc.) and just chat naturally: "Draw deucravacitinib", "Help me complete my lab book", "Extract structures from this image".
+
+### Claude Desktop
+
+Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac):
+
+```json
+{
+  "mcpServers": {
+    "cdxml-toolkit": {
+      "command": "python",
+      "args": ["-m", "cdxml_toolkit.mcp_server"]
+    }
+  }
+}
+```
+
+### opencode (for OpenRouter / local models)
+
+Create `opencode.json`:
+
+```json
+{
+  "provider": {
+    "openrouter": {
+      "models": { "qwen/qwen3.5-27b": {} }
+    }
+  },
+  "mcp": {
+    "cdxml-toolkit": {
+      "type": "local",
+      "command": ["python", "-m", "cdxml_toolkit.mcp_server"],
+      "enabled": true,
+      "timeout": 120000
+    }
+  }
+}
+```
+
+### Verify it works
+
+```
+> Use cdxml-toolkit. Resolve "aspirin", then draw it.
+```
+
+Expected: 2 tool calls (resolve_name, draw_molecule), produces an aspirin CDXML file.
+
+## MCP tools (15)
+
+### Chemistry resolution
+| Tool | Description |
+|------|-------------|
+| `resolve_name` | Name/abbreviation/CAS/formula to rich molecule JSON (5-tier: reagent DB, condensed formula, ChemScript, OPSIN, PubChem) |
+| `modify_molecule` | 6 operations: analyze, name_surgery, smarts, set_smiles, set_name, reaction. 162 named reaction templates. Returns MCS-based structural diffs. |
+
+### Structure rendering
+| Tool | Description |
+|------|-------------|
+| `draw_molecule` | Single molecule to CDXML |
+| `render_scheme` | YAML/compact text/reaction JSON to publication-ready CDXML. Forgiving parser handles common LLM YAML mistakes. |
+
+### Perception (reading existing chemistry)
+| Tool | Description |
+|------|-------------|
+| `parse_reaction` | ELN exports (CDXML/CDX/CSV/RXN) to semantic JSON with species, roles, SMILES, equivalents |
+| `summarize_reaction` | Context-efficient view of reaction JSON (select only the fields you need) |
+| `extract_structures_from_image` | Image to SMILES + confidence scores via DECIMER neural network |
+| `parse_scheme` | CDXML scheme to structured species/steps/topology JSON |
+
+### Analysis
+| Tool | Description |
+|------|-------------|
+| `parse_analysis_file` | LCMS (Waters/manual) or NMR (MestReNova) PDF to structured peak data |
+| `format_lab_entry` | Structured entry dicts to formatted lab book text. Re-reads LCMS PDFs for exact numbers. |
+
+### Office integration
+| Tool | Description |
+|------|-------------|
+| `extract_cdxml_from_office` | Pull embedded ChemDraw OLE objects from PPTX/DOCX |
+| `embed_cdxml_in_office` | Inject CDXML as editable ChemDraw OLE into PPTX/DOCX |
+| `convert_cdx_cdxml` | Bidirectional CDX/CDXML conversion |
+| `search_compound` | Find a molecule across experiment directories by SMILES similarity |
+| `render_to_png` | CDXML to PNG via ChemDraw COM |
+
+## Design principles
+
+**Never trust LLM-generated SMILES.** The agent always goes through `resolve_name` to get grounded SMILES from databases. Direct SMILES generation is the #1 source of chemistry hallucination.
+
+**Verify every transformation.** `modify_molecule` returns aligned IUPAC name diffs and MCS-based molecular diffs after every edit. The agent can confirm the transformation is correct.
+
+**Never flood the agent.** Large outputs (CDXML, JSON) always write to files and return `{ok: true, output_path: "...", size: 23456}`. The agent never gets 30KB of XML in its context window.
+
+**Forgiving inputs.** The YAML parser accepts 9+ common LLM mistakes (inline structures, `substrates` as alias for `structures`, text as string not list, bare SMILES, `above_arrow` as list/string). Input parameters accept bare SMILES strings, stringified JSON arrays, and fuzzy operation names.
+
+**Actionable errors.** Every error tells the agent what to do instead: "Did you mean: BOC_deprotection?", not "KeyError".
+
+**Progressive discovery.** Call any tool with no arguments to get usage examples and schema reference.
+
+## Installation
+
+**Prerequisites:** Windows with ChemDraw (ChemOffice 2015+) and ChemScript installed.
+
+```bash
+# From GitHub — recommended install (includes RDKit, MCP server, ChemDraw COM,
+# Office support, PDF parsing, image processing, and ChemScript bridge)
+pip install "cdxml-toolkit[all] @ git+https://github.com/leehiufung911/cdxml-toolkit.git@main"
+
+# With DECIMER neural image extraction (extract_structures_from_image)
+pip install "cdxml-toolkit[all,decimer] @ git+https://github.com/leehiufung911/cdxml-toolkit.git@main"
+
+# Development (editable install)
+git clone https://github.com/leehiufung911/cdxml-toolkit.git
+cd cdxml-toolkit
+pip install -e ".[dev]"
+```
+
+**Required:** `lxml>=4.6`. **Recommended:** `rdkit>=2023.03` (needed for scheme rendering).
+
+### Extras
+
+| Extra | What it includes | Notes |
+|-------|-----------------|-------|
+| `[all]` | RDKit, pywin32, image, Office, YAML, PDF analysis, MCP server, pythonnet, py2opsin | **Use this.** Everything most users need. |
+| `[decimer]` | TensorFlow, DECIMER, PyMuPDF | Neural image-to-SMILES. Adds ~1 GB. |
+| `[full]` | `[all]` + `[decimer]` + `[ocr]` | Everything pip-installable. |
+| `[rdkit]` | RDKit only | Minimal install for scripting. |
+| `[mcp]` | MCP server + PyYAML | MCP server only (no RDKit/Office). |
+| `[dev]` | `[all]` + pytest | For running the test suite. |
+
+### Name resolution tiers
+
+`resolve_name` tries 5 tiers in order. The first tier to return a valid SMILES wins:
+
+| Tier | Source | Deps | Coverage |
+|------|--------|------|----------|
+| 1 | Curated reagent DB (186 entries) | None | Common reagents, catalysts, solvents |
+| 2 | Condensed formula parser | RDKit | Shorthand like PhB(OH)2, Et3N, CF3 |
+| 3 | **ChemScript** (preferred) | ChemDraw + 32-bit Python | Full IUPAC names, any drawable structure |
+| 4 | **OPSIN** (bundled fallback) | py2opsin + bundled JRE | Systematic IUPAC names, offline |
+| 5 | PubChem | Network | CAS numbers, trade names, everything else |
+
+ChemScript (Tier 3) is preferred because it handles the widest range of names and integrates with ChemDraw's structure engine. OPSIN (Tier 4) is a fully offline fallback that works out of the box — a JRE is bundled with the package, no Java install needed. If neither is available, PubChem provides a network-based last resort.
+
+### System dependencies (not pip-installable)
+
+| Dependency | Required for | Setup |
+|-----------|-------------|-------|
+| **ChemDraw** (ChemOffice 2015+) | CDX conversion, PNG rendering | Must be **closed** before running COM tools. |
+| **ChemScript .NET** | Name resolution Tier 3 (preferred, not required) | Comes with ChemOffice. See setup below. |
+| **Microsoft Office** | OLE embedding into PPTX/DOCX | Optional. Only needed for `embed_cdxml_in_office`. |
+
+### ChemScript setup (optional but recommended)
+
+ChemScript gives the best IUPAC name resolution but requires a 32-bit Python environment because the ChemScript .NET DLL is 32-bit. If you skip this, OPSIN handles IUPAC names as a fallback.
+
+```bash
+# 1. Create 32-bit Python env
+set CONDA_SUBDIR=win-32 && conda create -n chemscript32 python=3.10 -y
+
+# 2. Install pythonnet in the 32-bit env
+C:\Users\%USERNAME%\miniconda3\envs\chemscript32\python.exe -m pip install pythonnet
+
+# 3. Auto-detect ChemDraw and save config
+cdxml-convert --configure
+```
+
+Step 3 scans for ChemDraw (2015/2016/PerkinElmer paths) and writes `~/.chemscript_config.json`. If your ChemDraw is in a non-standard location, edit the config manually:
+
+```json
+{
+  "python32": "C:\\Users\\YOU\\miniconda3\\envs\\chemscript32\\python.exe",
+  "dll_dir": "C:\\Program Files (x86)\\PerkinElmerInformatics\\ChemOffice2016\\ChemScript\\Lib\\Net",
+  "assembly": "CambridgeSoft.ChemScript16"
+}
+```
+
+## CLI tools
+
+All tools are also available as command-line scripts:
+
+| Command | Description |
+|---------|-------------|
+| `cdxml-mcp` | MCP server (primary interface) |
+| `cdxml-parse` | Parse reaction files to JSON |
+| `cdxml-render` | Render JSON/YAML/compact text to CDXML |
+| `cdxml-convert` | CDX/CDXML bidirectional conversion |
+| `cdxml-image` | CDXML to PNG/SVG (ChemDraw COM) |
+| `cdxml-merge` | Merge multiple reaction schemes |
+| `cdxml-layout` | Clean up reaction layout (pure Python) |
+| `cdxml-ole` | Embed CDXML as editable OLE in PPTX/DOCX |
+| `cdxml-lcms` | Parse LCMS PDF reports |
+| `cdxml-nmr` | Extract NMR data from MestReNova PDFs |
+| `cdxml-format-entry` | Format lab book entries |
+| `cdxml-discover` | Discover experiment files in a directory |
+
+## Scheme DSL
+
+The renderer accepts three input formats:
+
+**YAML** (what agents typically write):
+```yaml
+layout: sequential
+structures:
+  SM:
+    smiles: "Brc1ncnc2sccc12"
+  Product:
+    smiles: "c1nc(N2CCOCC2)c2ccsc2n1"
+steps:
+  - substrates: [SM]
+    products: [Product]
+    above_arrow:
+      structures: [Morph]
+    below_arrow:
+      text: ["Pd2(dba)3", "BINAP", "Cs2CO3", "Dioxane, 105 C"]
+```
+
+**Compact text** ("Mermaid for reactions"):
+```
+SM: {Brc1ncnc2sccc12}
+SM --> Product{c1nc(N2CCOCC2)c2ccsc2n1}
+  above: Morph{C1COCCN1}
+  below: "Pd2(dba)3", "BINAP", "Cs2CO3"
+```
+
+**Reaction JSON** (from parse_reaction):
+```bash
+cdxml-render --from-json reaction.json -o scheme.cdxml
+```
+
+## Running tests
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+[MIT](LICENSE)
+
+## Attribution
+
+See [NOTICE.md](NOTICE.md) for third-party data attribution (ChemScanner, RDKit).
+
+## Author
+
+Hiu Fung Kevin Lee ([@leehiufung911](https://github.com/leehiufung911))

cdxml_toolkit-0.5.0/cdxml_toolkit/__init__.py

@@ -0,0 +1,18 @@
+"""cdxml-toolkit: Python toolkit for ChemDraw CDXML reaction scheme processing.
+
+Provides tools for reading, writing, manipulating, and rendering ChemDraw CDXML
+files. Includes reaction scheme layout, reagent classification, structure
+alignment, and a declarative DSL for building schemes from YAML or text.
+
+Core utilities are available without optional dependencies. RDKit, ChemDraw COM,
+and other heavy dependencies are lazy-imported and only required when their
+specific features are used.
+"""
+
+__version__ = "0.5.0"
+
+# Core utilities — always available (stdlib + lxml only)
+from .constants import ACS_BOND_LENGTH, ACS_CHAIN_ANGLE, ACS_STYLE
+from .cdxml_utils import parse_cdxml, write_cdxml, fragment_bbox
+from .text_formatting import build_formatted_s_xml
+from .resolve.reagent_db import get_reagent_db

cdxml_toolkit-0.5.0/cdxml_toolkit/_jre/__init__.py

@@ -0,0 +1,2 @@
+# Bundled Eclipse Temurin JRE 21 (Windows x64) for OPSIN.
+# License: GPL v2 with Classpath Exception (allows bundling).