用途
该技能用于部署 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 数不等于残基数。