SuperAPI AI 工具集

esm

编程与开发

查看项目

更新于 10-16 10:22

技能介绍

用途:面向 Biohub esm Python SDK,覆盖 ESM3 掩码多模态生成、ESMC 序列表示提取和 ESMFold2 全原子结构预测。原 Forge 平台已迁移至 https://biohub.ai,SDK 类名中仍保留 Forge。目标版本为 esm 3.4.1.post1。注意 fair-esm 是 Meta 较旧的 ESM2/ESMFold/ESM-IF 发行版,两者均以 esm 导入,须分环境安装;旧 esm.pretrained.esm2_* 接口与 ESMC 接口不同,Hugging Face Transformers 的原生 ESMC 实现也是另一套 API。

安装与模型:uv venv --python 3.12 .venv-esm;uv pip install --python .venv-esm/bin/python "esm==3.4.1.post1"。该版本要求 Python >=3.12、Torch >=2.11,<2.12、Transformers >=4.57.6,<5。任务模型对应:ESM3 生成用 ESM3.from_pretrained("esm3-sm-open-v1") 或托管 client("esm3-medium-2024-08");ESMC 嵌入用 EsmcForMaskedLM 与 EsmcTokenizer,本地权重 biohub/ESMC-300M、600M、6B,托管 esmc_client("esmc-600m-2024-12");ESMFold2 用 EsmFold2Model 与 ESMFold2InputBuilder,本地 biohub/ESMFold2,托管 esmfold2_client("esmfold2-fast-2026-05")。

工作流:明确序列/链/残基映射与目标(生成、表示提取或折叠),保留输入 ID 与来源,拒绝含空格、FASTA 头或间隙的单链序列;记录 SDK、检查点版本、设置、掩码位置与随机种子;检查 ESMProteinError,托管失败可能以返回值形式出现,使用有限超时、上下文管理器与有界并发;校验输出契约并区分预测与实验验证。

限制:ESM3 生成仅填充掩码位置,重复调用不构成精修或温度退火;预测坐标、pLDDT、pTM 不衡量热力学稳定性、结合亲和力或催化活性;嵌入相似度不保证同源或功能一致;数据集小应谨慎使用固定 PCA/t-SNE 设置。预训练 ESM3/ESMC/ESMFold2、CUDA 推理与认证服务未在本技能验证中执行。本地与托管模型、账号配额受不同约束。