Skip to content

Fix multiprocessing on Windows and update README for v0.3.0 - #49

Merged
afloresep merged 2 commits into
masterfrom
fix/windows-forkserver-readme
Sep 11, 2026
Merged

afloresep merged 2 commits into
masterfrom
fix/windows-forkserver-readme

Conversation

@afloresep

Copy link
Copy Markdown
Owner

Fixes #48

_get_mp_context asked for the forkserver start method on every platform except macOS. forkserver is Unix-only, so on Windows every pooled chemistry helper (fingerprints_from_smiles, molecular_properties, murcko_scaffolds) failed with cannot find context for 'forkserver'. Windows now uses spawn, with regression tests.

Windows remains untested and unsupported. Wheels are built for Linux x86_64 and macOS arm64 only. The README now says so and points to WSL2, and pyproject.toml gets matching Operating System classifiers.

The README Quick Start also called write_html and show on the TMAP model. Those methods live on TmapViz, so the first example raised an AttributeError. Both snippets now go through to_tmapviz(). The rest of the README is brought up to v0.3.0: return_valid, hop counts, kNN component bridging, reproducible, the inspector (neighbors, tree paths, colour by tree distance), add_filter, configure_column, 3D structure helpers, the full domain-utilities list, and a link to the examples index.

_get_mp_context asked for "forkserver" on every platform except macOS,
but forkserver is Unix-only. On Windows every pooled chemistry helper
(fingerprints_from_smiles, molecular_properties, murcko_scaffolds)
failed with "cannot find context for 'forkserver'" before any RDKit
work started. Use "spawn" on Windows as well as macOS.

Fixes #48

Claude-Session: https://claude.ai/code/session_0126UJi2YmQewF8Sn35tXh16
The Quick Start called write_html and show on the TMAP model; those
live on TmapViz, so the first example in the README raised an
AttributeError. Route both snippets through to_tmapviz() and add the
missing imports.

Also bring the README up to date with v0.3.0: return_valid in
fingerprints_from_smiles, hop counts, kNN component bridging, the
reproducible flag, the inspector (neighbors, tree paths, colour by tree
distance), add_filter, configure_column, 3D structure helpers, the full
list of domain utilities, and a pointer to the examples index. Qualify
the determinism claim: the layout is always deterministic, the HNSW
build only with reproducible=True.

State that wheels are built for Linux x86_64 and macOS arm64 only and
that Windows is unsupported (use WSL2), and add matching Operating
System classifiers to pyproject.toml.

Claude-Session: https://claude.ai/code/session_0126UJi2YmQewF8Sn35tXh16
@afloresep
afloresep merged commit 9cd3442 into master Sep 11, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Forkserver problem in W11 running with python 3.13

1 participant