安装独立 AiZynthFinder 环境，下载公开策略、模板与库存文件，执行有明确限制和来源记录的逆合成搜索。
AiZynthFinder 4.4.1 使用独立 Python 3.11 环境，上游 Python 范围为 >=3.10,<3.13，依赖的 RDKit 范围与其他方案不同，不合并虚拟环境。参考流程采用本地 ONNX 策略与公开库存快照，不调用托管推理端点。模型、模板、库存下载需要网络及较多磁盘空间，核对数据许可并保存文件摘要。
搜索仅在指定策略、库存和预算下提出模型路线。solved 表示末端符合配置库存规则，不代表实验成功，也不保证原料当前可购买。零路线是合法观察结果，不使用生成化学路线补齐。搜索时限不包含所有启动或下载开销，数值结果可能随版本及搜索状态变化。
AiZynthFinder
本地逆合成搜索引擎 · ==4.4.1
独立 Python 3.11 环境，公开模型、模板及库存为另外必需下载的数据。
费用与许可请核对上游及客户端、服务账号条款。
查看资源| 客户端 | 操作系统 | 架构 | 版本要求 |
|---|---|---|---|
| Python | macOS | 不限 | >= 3.10 <= 3.12 |
| Python | Windows | 不限 | >= 3.10 <= 3.12 |
| Python | Linux | 不限 | >= 3.10 <= 3.12 |
全部平台
使用独立 Python 3.11，准备模型与库存文件的可写空间，下载前检查上游公开数据引用，使用新数据目录。
环境符合 Python >=3.10,<3.13。
macOS
在新的工作目录执行。此命令适用于 macOS/Linux，Windows 使用单独步骤。
python3.11 -m venv .venv
.venv/bin/python -m pip install aizynthfinder==4.4.1
.venv/bin/python -m pip freeze
依赖安装完成，记录实际解析版本。
Linux
在新的工作目录执行。此命令适用于 macOS/Linux，Windows 使用单独步骤。
python3.11 -m venv .venv
.venv/bin/python -m pip install aizynthfinder==4.4.1
.venv/bin/python -m pip freeze
依赖安装完成，记录实际解析版本。
Windows
使用 PowerShell，直接调用虚拟环境解释器。
py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install aizynthfinder==4.4.1
.\.venv\Scripts\python.exe -m pip freeze
依赖安装完成，记录实际解析版本。
macOS
使用新的 public-data 目录。上游下载器会写入模型、模板、库存与 config.yml，不要指向已有数据。
mkdir public-data
.venv/bin/download_public_data public-data
所有引用文件与生成的 config.yml 存在，记录大小和文件摘要。
Linux
在新目录中使用同一下载器。
mkdir public-data
.venv/bin/download_public_data public-data
引用数据文件存在。
Windows
在新的工作目录中通过 PowerShell 执行。
mkdir public-data
.\.venv\Scripts\download_public_data.exe public-data
引用数据文件存在。
全部平台
保存为 config_local.yml，将路径替换为实际下载文件，保留原生成的 config.yml。Windows 可使用带引号的正斜杠路径，如 C:/work/public-data/...。uspto 策略必须对应已下载的模型与模板。
search:
max_transforms: 4
iteration_limit: 50
time_limit: 30
exclude_target_from_stock: true
expansion:
uspto:
- /ABSOLUTE/PATH/public-data/uspto_model.onnx
- /ABSOLUTE/PATH/public-data/uspto_templates.csv.gz
filter:
uspto: /ABSOLUTE/PATH/public-data/uspto_filter_model.onnx
stock:
zinc: /ABSOLUTE/PATH/public-data/zinc_stock.hdf5
全部配置文件实际存在，搜索限制明确。
全部平台
Windows 使用 ..venv\Scripts\aizynthcli.exe。选择新的输出路径，保留 CLI 日志供审核。
.venv/bin/aizynthcli --config config_local.yml --smiles "CC(=O)Oc1ccccc1C(=O)O" --policy uspto --stocks zinc --output aspirin-routes.jsonCLI 成功载入策略与库存并写入实际输出文件；从真实结果记录目标、搜索统计、number_of_routes 和 is_solved。不要求特定路线，不将 solved 等同于实验可行。
全部平台
作为人工核对清单，或向可选助手提供实际输出；上传云端会改变仅本地的隐私前提。
检查提供的 AiZynthFinder 阿司匹林输出，报告实际路线数、solved 状态、策略、库存及搜索预算。区分模型提议与实验依据；没有路线时如实说明，不生成替代路线。核对结果与真实输出及其局限一致。
可使用上游 notebook/UI 检查同样的模型和库存。人工依据文献审查路线属于另一个流程，不能自动证明模型输出有效。