---
title: BioPhi quickstart
description: Call biophi_humanness for an OASis score and class, or biophi_humanize and biophi_graft to return a humanized VH/VL with the mutations made.
tags:
  - biophi
  - quickstart
---

You have an antibody VH/VL pair and you want to know how human it is — and, if it isn't human enough, a humanized version that keeps the CDRs. [BioPhi](/docs/biophi) does both: paste the sequences, pick a mode, submit, and read the OASis score or the humanized sequence off the result card.

## Score or humanize

### Provide VH (and VL)

Paste the heavy-chain variable-region sequence, and the light chain too if you have it. Or name a known therapeutic and let the platform resolve the VH/VL from Thera-SAbDab.

### Pick which tool to call

Call `biophi_humanness` to only score, `biophi_humanize` to rewrite the sequence with the Sapiens model, or `biophi_graft` to humanize by CDR grafting — the mode follows from which one you call. For humanization, set a target humanness; `biophi_humanize` also lets you toggle whether known binding residues stay fixed.

### Submit and wait

BioPhi runs as an asynchronous CPU job on Modal. Submit it, and a result card appears on the canvas when the job finishes.

### Read the result

In scoring mode the card shows the OASis humanness score, percentile, and human/humanized/chimeric/murine class, broken down per CDR and framework. In humanization mode it also shows the humanized VH/VL and the mutations made.

## In chat

Describe the antibody and what you want done — the model routes to BioPhi and chains numbering, repertoire mining, or stability around it.

**Try this prompt** — [open in a guest chat](/chat/new?guest=true&prompt=Look%20up%20pembrolizumab%20in%20TheraSAbDab%2C%20annotate%20its%20heavy%20chain%20with%20IgBLAST%20for%20V%2FD%2FJ%20germline%20assignment%2C%20run%20ANARCI%20for%20CDR%20numbering%2C%20score%20joint%20VH%2FVL%20humanness%20with%20BioPhi%20and%20Humatch%20%E2%80%94%20which%20framework%20positions%20deviate%20most%20from%20germline%2C%20and%20which%202-3%20back-mutations%20would%20most%20improve%20humanness%20for%20a%20biosimilar%20strategy%3F).

> Look up pembrolizumab in TheraSAbDab, annotate its heavy chain with IgBLAST for V/D/J germline assignment, run ANARCI for CDR numbering, score joint VH/VL humanness with BioPhi and Humatch — which framework positions deviate most from germline, and which 2-3 back-mutations would most improve humanness for a biosimilar strategy?

## What to do next

- **Confirm manufacturability** — run [antibody developability](/docs/antibody-developability) on the humanized candidate, since humanization can shift charge and aggregation.
- **Number the humanized sequence** — run [ANARCI](/docs/anarci) to re-annotate CDRs.
- **Cross-check with a second metric** — score the same sequence with [Humatch](/docs/humatch).

## Read next