SuperAPI AI 工具集

setup-bioemu2-remote-tool

智能体与模型

查看项目

更新于 10-27 06:20

技能介绍

用途

该技能用于部署 ToolUniverse 的 BioEmu-2 远程工具:完成环境准备、权重下载与固定、冒烟验证、本地启动,并可选择通过 ToolUniverse Connect 中继对外共享。适用于在具备 NVIDIA CUDA GPU 的 Linux 主机(Python 3.12.3,从 ToolUniverse 仓库根目录运行)上搭建 BioEmu-2 结构采样服务。

主要能力

  • 预检:运行 python scripts/remote_validation/setup_skill_preflight.py --implementation bioemu2,可追加 --check-provider-env、--live(不跑模型,仅校验 MCP 工具集)和 --check-connect-prereqs(仅报告密钥是否设置,不打印值)。
  • 双环境安装:MCP 服务器运行在 ToolUniverse 环境,模型运行在独立环境 TOOLUNIVERSE_BIOEMU2_PYTHON 指向的解释器中,由 tu remote setup --only environment 依据 requirements.lock 以 --no-deps 填充。资料记录了 bioemu2 仅以 0.1.0rc0 发布、hydra-core 1.3.7 与 omegaconf 2.3.0 配对的解析陷阱。
  • 四步设置:tu remote setup bioemu2,可用 --only preflight|environment|weights|smoke 分步执行。冒烟步骤加载模型、发送一次请求、断言产出 topology.cif 和 samples.xtc,并把实测峰值显存写入 ~/.cache/tooluniverse/measured/bioemu2.json。
  • 凭据与权重:无需凭据,检查点在 Hugging Face Hub 上以 MIT 许可公开;BIOEMU2_HF_HOME 指定缓存目录(默认 ~/.cache/tooluniverse/bioemu2-hf)。启动时若文件偏离固定值则拒绝运行。
  • 共享与本地运行:tu remote login 后 tu remote share bioemu2 进行私有共享;tu remote check 为非共享就绪检查,tu remote run 为本地前台服务器。
  • 本地验证:python -m tooluniverse.remote.bioemu2.bioemu2_tool 启动后,Streamable HTTP 端点为 http://127.0.0.1:8063/mcp,需确认工具发现包含 bioemu2_sample_structures。
  • 调用示例:bioemu2_sample_structures 接受 sequences、mode、num_samples、seed、msa_a3m 等参数;对配体、核酸、修饰残基等可使用 system_yaml。返回包含 mode、num_samples、tokens、chains、msa 来源、physicality、files、timing、weights_held_by 与显存指标;return_topology 默认关闭。

适用场景与限制

资料验证状态(2026-10-25)显示:仅在 NVIDIA GB10 单卡上通过本 provider 路径完成四步设置,冒烟测试 89 秒通过,MCP 端点 3 次正确调用、6 次畸形请求返回命名拒绝。仅蛋白质链经过 worker;配体、RNA、DNA、接触条件化、引导采样及除 high_quality 外的物理性模式均未测试。集成准确度未验证,物理性报告只描述几何,采样频率不是校准的玻尔兹曼概率。公开出版、跨用户隔离、并发、恢复与长输入未测试,建议保持私有部署。GPU 侧建议单 worker,按 vram_budget_gb(声明 16.0 GiB)而非分配峰值做预算;token 上限 448,token 数不等于残基数。