humatch

Align, classify, and humanise antibody sequences with Humatch in Docker.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/yjcyxky/biominer-skills --skill humatch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: humatch
Source: https://github.com/yjcyxky/biominer-skills/tree/main/humatch
Command: npx skills add https://github.com/yjcyxky/biominer-skills --skill humatch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the end-to-end processing of antibody sequences by performing alignment, humanness classification, and joint humanisation using Humatch inside a Docker container. It enables single-sequence workflows as well as batch processing via CSV inputs, with configurable germline-likeness constraints and CNN-based targeting for quality humanisation.

Core Features & Use Cases

  • CLI-driven workflows: run alignment, classification, and humanisation from the command line inside the Humatch container.
  • Flexible sequencing support: process heavy/light chains individually or together, including prealigned 200-position inputs.
  • Batch and custom configs: handle CSV inputs and tune behavior with a YAML config for germline-likeness and fixed target positions.
  • Use Case: Researchers can align VH/VL, estimate humanness scores, and generate humanised sequences for candidate antibodies in a reproducible Docker environment.

Quick Start

Start the Humatch workflow by running the container image with your data (single pair or CSV) and following the examples in the SKILL description. For example, align a heavy and light chain or run a full classification and humanisation pipeline using the provided CLI.

Frequently Asked Questions about humatch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run antibody humanisation and alignment for VH and VL chains?

Antibody humanisation and alignment for VH and VL chains is executed via CLI inside a Docker container using the Humatch image. You process heavy and light chains individually or together with configurable germline-likeness targets.

Can I batch process antibody sequences using a CSV file?

Yes, batch processing antibody sequences is supported using CSV inputs. The Docker-based Humatch workflow reads the CSV file to align sequences, classify humanness, and generate humanised outputs for multiple candidates.

Do I need Docker to perform humanness classification and germline-likeness targeting?

Docker is required for humanness classification and germline-likeness targeting. The Skill runs end-to-end processing inside the Humatch container image, ensuring reproducible alignment and humanisation under CNN constraints.

What is antibody humanisation and when do I need prealigned 200-position inputs?

Antibody humanisation modifies non-human antibody sequences to increase human likeness. Prealigned 200-position inputs are needed when processing preformatted heavy or light chain sequences for CNN-based humanness classification.

Why does the Humatch Docker container fail to download model assets automatically?

The Humatch Docker container requires network access for initial model asset downloads. If auto-download fails due to network restrictions, you can manually supply the necessary model assets to the container.

Can I configure fixed target positions for antibody humanisation?

Yes, fixed target positions for antibody humanisation can be configured using a YAML config file. This allows tuning behavior and setting specific germline-likeness constraints during the CNN-based humanisation process.