NVIDIA protein model outputs#

NvidiaNIM_proteinmpnn designs sequences from a backbone; NvidiaNIM_esmfold predicts a monomer structure from a sequence. They require NVIDIA_API_KEY. The output format is selected by the tool configuration, so an HTTP text/plain response does not automatically mean PDB coordinates.

Reading results#

Check status before saving or evaluating a prediction. HTTP 200 can contain an inner model failure; ToolUniverse returns those responses with status="error" and retains the native JSON in data. An empty or malformed PDB JSON envelope is also an error, rather than a successful structure.

ProteinMPNN JSON responses retain the native fields (including mfasta and any scores) under data. Plain Multi-FASTA responses expose the complete text as both data["mfasta"] and sequences, with format="mfasta".

ESMFold returns PDB text as data and structure, with format="pdb". When a JSON response contains multiple PDB strings, structures retains all of them in their original order; structure remains the first one for existing callers. A valid single-structure result omits structures.

# result is the complete response from tu.run_one_function(...).
if result.get("status") != "success":
    raise RuntimeError(result.get("error", "Prediction failed"))

if result.get("format") == "mfasta":
    fasta = result["data"]["mfasta"]
elif result.get("format") == "pdb":
    pdbs = result.get("structures", [result["structure"]])

In a multi-model workflow, retain each original response and all returned samples alongside model names, versions, inputs and seeds. Count failed calls separately from completed predictions. Structural confidence scores alone do not establish binding affinity or pH selectivity.

NVIDIA documents ProteinMPNN’s output as Multi-FASTA in its ProteinMPNN overview.