---
title: Humatch quickstart
description: Paste a sequence, set the chain to H or L, and read back a humanness score, the closest human germline V gene, and the low-humanness positions to target.
tags:
  - humatch
  - quickstart
---

You have an antibody sequence and you want a humanness read — an overall score, the least-human positions, and the closest human germline. [Humatch](/docs/humatch) does it from sequence alone: paste the sequence, tell it whether the chain is heavy or light, submit, and read the score and flagged positions off the result card.

## Score a sequence

### Provide sequences

Paste one or more antibody variable-region sequences (up to 50 per job). Name them if you want the labels carried through.

### Set the chain type

Choose `H` for heavy chains or `L` for light (kappa or lambda). Keep the default `imgt` numbering scheme unless a downstream convention needs Chothia or Kabat.

### Submit and wait

Humatch runs as an asynchronous CPU job on Modal. Submit it, and a result card appears on the canvas when the job finishes — typically within two to three minutes.

### Read the score

The card shows each sequence's humanness score, whether it passes your threshold, the closest human germline V gene, and the flagged low-humanness positions to target for humanization.

## In chat

Describe the antibody and ask for a humanness read — the model routes to Humatch and pairs it with numbering or annotation when your prompt asks.

**Try this prompt** — [open in a guest chat](/chat/new?guest=true&prompt=Look%20up%20pembrolizumab%20in%20TheraSAbDab%2C%20run%20ANARCI%20numbering%2C%20BioPhi%20humanness%20assessment%2C%20then%20predict%20paratope%20residues%20with%20Paragraph%20and%20score%20CDR%20loop%20stability%20with%20ThermoMPNN%20%E2%80%94%20provide%20a%20go%2Fno-go%20recommendation%20on%20whether%20additional%20humanization%20is%20needed%20with%20specific%20positions%20that%20won't%20disrupt%20binding.).

> Look up pembrolizumab in TheraSAbDab, run ANARCI numbering, BioPhi humanness assessment, then predict paratope residues with Paragraph and score CDR loop stability with ThermoMPNN — provide a go/no-go recommendation on whether additional humanization is needed with specific positions that won't disrupt binding.

## What to do next

- **Humanize the flagged positions** — feed the sequence into [BioPhi](/docs/biophi) for Sapiens humanization or CDR grafting.
- **Check manufacturability** — run [antibody developability](/docs/antibody-developability).
- **Map the paratope** — run [Paragraph](/docs/paragraph) so you humanize away from binding residues.

## Read next