把 Protenix(结构预测)和 PXDesign(蛋白设计)打成可在 NVIDIA GPU 机器上原生安装的命令行工具,并可与对外提供队列与接口的 Go 服务 protenix_service 整合安装。不用 Docker、conda。
两种用法互不干扰:
- 独立使用:单产品包,
install_<app>.sh装到~/.local/share/<app>(<APP>_PREFIX可改),不需要 sudo。 - 与 Go 服务一起安装:整合包,root 跑
install_protenix_service.sh,按 Go 模板 install 体系把服务和两个运行时统一装到/protenix_service(运行时目录由脚本显式传入,不读独立模式的默认值)。
每个 arch 三个 zip:
protenix_linux_{amd64,arm64}_release_v*.zip、pxdesign_linux_{amd64,arm64}_release_v*.zip:独立单产品包protenix_service_linux_{amd64,arm64}_release_v*.zip:整合包(runtime/<app>/与单产品包内容相同)
解压后:
install_<app>.sh 安装/升级/回退/卸载/状态
README.md 使用说明
bin/<app>-run 安装后复制到安装目录的命令入口
conf/<app>.env 运行配置模板
scripts/ 安装脚本(install_prefix_*、install_common、weights_reuse)
deps/ patches/ 依赖版本覆盖与运行期补丁
src/<app>/ src/SRC_SHA 上游源码快照(不依赖本仓库)
examples/ 示例输入
BUILD_INFO.txt 版本、提交、源码 sha
前置条件:NVIDIA 驱动 + CUDA 13 工具链(nvidia-smi、nvcc,默认 CUDA_HOME=/usr/local/cuda-13.0);uv,能解析 Python 3.14;公网访问(pip 依赖、模型权重)。
unzip protenix_linux_arm64_release_v*.zip && cd protenix
./install_protenix.sh install
# PXDesign 同理
unzip pxdesign_linux_arm64_release_v*.zip && cd pxdesign
./install_pxdesign.sh install| 命令 | 行为 |
|---|---|
install |
首次安装到 $<APP>_PREFIX(默认 ~/.local/share/<app>) |
update |
用当前包升级;新版本构建失败不影响原版本,配置和权重保留 |
rollback |
回到上一版本 |
uninstall / uninstall --purge |
卸载程序保留配置和权重 / 连同配置和权重一起删除 |
status |
版本、提交、是否可运行 |
换安装目录:PROTENIX_PREFIX=/dir(或 PXDESIGN_PREFIX=/dir)。复用已有权重跳过下载:WEIGHTS_REUSE_FROM=/已有/prefix/根。
安装后目录:bin/<app>-run、conf/<app>.env、data/(权重)、releases/<版本>/(每版一套 venv,current/previous 符号链接指向)。
~/.local/share/protenix/bin/protenix-run pred -i input.json -o out --use_msa false -s 101
~/.local/share/pxdesign/bin/pxdesign-run pipeline --preset preview -i task.yaml -o out --N_sample 2成功条件:退出码 0、输出目录有 .cif、无 ERR/、GPU 有占用。详细步骤(切模型、FAQ)见各包内 README.md。
解压后:
protenix_service/
protenix_service 服务二进制
protenix_service.service systemd 单元(User=root,WorkingDirectory=/protenix_service)
install_protenix_service.sh 安装 / 升级 / 卸载 / 运行时回退 / 状态(菜单)
conf/config.yaml 服务配置(cli_cfg 指向 /protenix_service/runtime/...)
BUILD_INFO.txt 版本、提交
runtime/protenix/ runtime/pxdesign/ 与单产品包内容相同
- root 权限(安装到
/protenix_service,单元放到/etc/systemd/system) - NVIDIA 驱动 + CUDA 13 工具链(
nvidia-smi、nvcc,默认CUDA_HOME=/usr/local/cuda-13.0) - uv,能解析 Python 3.14。root 的
PATH里没有 uv 时用UV=/path/to/uv指定 - 公网访问:安装时用 uv/pip 建 Python 环境,并从上游官方地址下载公开权重
unzip protenix_service_linux_arm64_release_v*.zip
cd protenix_service
# 以 root 执行(用 sudo 时写成 sudo env UV=/path/to/uv ./install_protenix_service.sh)
UV=/path/to/uv ./install_protenix_service.sh
# 选 1菜单:
| 选项 | 行为 |
|---|---|
| 1 install | 安装或重装。先装/升级两个运行时(失败则不动二进制与配置);再把旧二进制、conf/config.yaml、runtime/<app>/conf/<app>.env 备份为 .bak_<时间戳> 后覆盖;复制单元到 /etc/systemd/system,enable + start |
| 2 update | 升级:停服务,升级两个运行时(保留 <app>.env 与权重;新版本构建失败时当前版本不动、旧服务重新启动);只换二进制(旧的留 .bak_<时间戳>),不动 conf/config.yaml;更新单元后 restart |
| 3 uninstall | 整体卸载:disable --now 并删除单元,删除整个 /protenix_service(含运行时的 Python 环境与权重) |
| 4 rollback runtime | 两个运行时各自切回上一版本(previous),前后停启服务;服务二进制回退用 .bak_* |
| 5 status | 服务状态与两个运行时的版本、是否可运行 |
选项 1–3 完成后按模板约定删除解压目录和 zip;4、5 不删。复用已有机器上的权重跳过下载:WEIGHTS_REUSE_FROM=<已校验的 prefix 根>(与 UV 一样作为环境变量传给 install 脚本)。
| 路径 | 内容 |
|---|---|
/protenix_service/protenix_service |
服务二进制;旧版本 protenix_service.bak_<时间戳> |
/protenix_service/conf/config.yaml |
服务配置;重装时旧配置 config.yaml.bak_<时间戳> |
/protenix_service/data/ |
SQLite(protenix_service.db)、作业目录 cli_jobs/<task_id>/ |
/protenix_service/logs/ |
服务日志 |
/protenix_service/runtime/protenix/ |
bin/protenix-run、conf/protenix.env、data/(权重与 CCD)、releases/<版本>/venv、current、previous |
/protenix_service/runtime/pxdesign/ |
bin/pxdesign-run、conf/pxdesign.env、data/(权重、AF2/MPNN)、releases/<版本>/venv、current、previous |
/protenix_service/runtime/uv/ |
uv 托管的 Python 解释器(venv 依赖它)与 uv 缓存 |
/etc/systemd/system/protenix_service.service |
systemd 单元 |
服务通过 conf/config.yaml 的 cli_cfg 调用 /protenix_service/runtime/<app>/bin/<app>-run。protenix 的 v2 需要授权权重,cli_cfg.protenix.version_runtimes.v2.binary 默认为空(未配置时直接拒绝,不回退 v1)。
服务支持运行中查看当前业务阶段、只读回看历史步骤,并把业务状态数组与引擎调度诊断分开。页面启用条件、API 查询、关联排障及取消/恢复边界见任务操作说明;release 不加载调试页。
git clone <本仓库> && cd protenix_build
git submodule update --init --recursive
./gen_pre_build_config.sh all
FORCE_PACK=1 ./build.sh pack # 双 arch → build/upload_tmp_dir/ 下的单产品包与整合包
./build.sh pack linux_arm64 # 只打一个 arch- 需要 Go、bun(现场构建前端与 test_ui)、zip。服务二进制用 cgo(SQLite),打非本机 arch 时需交叉编译器(默认
x86_64-linux-gnu-gcc/aarch64-linux-gnu-gcc,可用CC_linux_amd64/CC_linux_arm64指定)。 - 发布包交付前先提交、再
FORCE_PACK=1,让BUILD_INFO.txt的 commit 对齐 HEAD。 - 发版入口是
git_tag.sh;Actions 用 ubuntu-24.04(amd64)和 ubuntu-24.04-arm(arm64)原生构建,六包完整校验后才发布,build.sh只负责构建。手动 dispatch 只构建;见双架构链路与操作。
./build.sh 子命令:pack 只打发布包(不跑 GPU/pip);protenix / pxdesign 只在仓库内 prefix/ 装/校验开发用运行时(uv + Python 3.14 + torch cu130,GPU 验证用,不是正式安装);all(默认)先打包再装两个 prefix。幂等:已就绪的步骤跳过;FORCE_PACK=1 / FORCE_PROTENIX=1 / FORCE_PXDESIGN=1 强制重做。
protenix 用最新上游;pxdesign 链依赖官方钉死的 Protenix v0.5.0+pxd。两者始终是独立 venv:独立模式各自安装;整合模式在 /protenix_service/runtime/ 下由同一个 install 流程安装、升级、卸载。
更多实现口径见 docs/design.md;机器验收记录见 docs/acceptance_*.md。
验证码实际生成后无条件写服务 INFO,邮件为独立可选能力,失败如实返回。配置、迁移、日志权限与排障边界见 操作说明。
当前 arm64 三包、release 服务与官方 v1/PXDesign HTTP/GPU 取件切片已实测;整合升级失败一致性、正式配置准备和 amd64 矩阵尚有缺口,不能宣称整系列可发版。见验收矩阵与证据。