chemvas 0.8.4

English · 한국어

Chemvas is an open-source desktop canvas for chemical structures and reaction schemes, with publication-ready export and scriptable document workflows.

Open the editable drawing · Get the SVG · Follow the walkthrough

Draw interactively. Automate safely. Export exactly.

• Draw interactively. Sketch structures, insert SMILES, label reaction arrows, and align molecules on a desktop canvas. Keep working in an editable drawing with autosave and crash recovery. SMILES insertion needs the optional RDKit backend.
• Automate safely. Compose, inspect, check layouts, and render documents from scripts. Graph edits check the source file's hash and validate the proposed changes before writing a new document.
• Export exactly. Save SVG, PDF, PNG, or TIFF with explicit physical-size presets, including 84 mm and 174 mm column widths. Keep the editable document alongside the exported figure.

Install and draw

Requires Python 3.12+. Install with SMILES support for the walkthrough:

pip install "chemvas[rdkit]"
chemvas

For drawing and figure export without RDKit, use pip install chemvas. PyQt6 is included in either installation. Desktop installers are not available yet; the supported distribution is the Python package.

Your first reaction scheme

This edited walkthrough uses the real application. The drawing is a schematic illustration, not an experimental result.

1. Enter OCc1ccccc1 in the SMILES field, click Insert, then click to place the structure. Hover over its oxygen, press Enter, and set the label to OH.
2. Insert O=Cc1ccccc1 to the right. Choose Arrow and drag between the two structures. Double-click the arrow to add its labels.
3. Select the scheme, then choose Edit ▸ Align ▸ Middle.
4. Save the drawing as .chemvas. Use File ▸ Export Figure… to export Plain SVG at Fit 2-column (174 mm).

The step-by-step guide includes the label text, downloadable files, and a command-line export example. The saved drawing opens and exports without RDKit.

Work with drawings from scripts

After downloading first-scheme.chemvas, try:

chemvas inspect-document first-scheme.chemvas
chemvas check-layout first-scheme.chemvas
chemvas render-document first-scheme.chemvas --output first-scheme-rendered.svg

Rendering creates a new file and leaves the source drawing untouched. This command uses preset bond-length sizing; the downloadable SVG above was exported with the desktop's 174 mm column setting. Layout checks cover visible note and atom-label text, shape borders, and arrow–structure crossings, not every possible overlap in a chemical scheme.

See the document CLI guide for composition, Graph Patch, render guarantees, and limits.

More workflows and documentation

• Chemistry I/O: SMILES import, MOL interchange, molecule information, and 3D XYZ export. Some operations require RDKit; see the reference.
• Calculation handoff (RDKit): elementary steps and reviewed precomplexes, exported as one machine.json per step. Details.
• Documents: editable .chemvas JSON files (version 7). Drawing tools and shortcuts · More examples · Current limits and roadmap.

Contribute

Try the example and share what got in your way. Small reproducible drawings, installation feedback, and documentation improvements are useful contributions. If Chemvas is useful to you, a star helps others find it.

For development, read CONTRIBUTING. make check runs lint, formatting, type checking, the file-isolated test suite, and document-handoff conformance checks.

Architecture · Changelog · Releasing · MIT License