
Evolve antibody sequences or score paired-antibody variants with a neural continuous-time Markov chain.
Antibody evolution is awaiting a published source asset
The CoSiNE webserver scores paired-antibody deep mutational scanning (DMS) variants with a neural continuous-time Markov chain. The available variant effect prediction (VEP) workflow returns CoSiNE log-likelihoods, perplexities, correlations with submitted experimental fitness, and optional Thrifty-corrected selection scores.
The interface also includes CoSiNE's unguided and predictor-guided antibody evolution controls. Evolution jobs are currently unavailable because the source project has not published the required RefineGNN binding-predictor checkpoint, so choose Variant effect prediction for a runnable job.
A CoSiNE submission currently has a fixed quote of 100 credits. The exact quote is shown before submission. Input size, scoring axes, branch lengths, and other settings do not currently change this quote.
| Input | Format | Required | Requirements |
|---|---|---|---|
| Paired-antibody DMS table | CSV, up to 10 MiB | Yes | One table with heavy-chain amino-acid sequences, light-chain amino-acid sequences, and numeric experimental fitness. All heavy sequences must have one consistent length, and all light sequences must have one consistent length. |
| Heavy-chain coding sequence | FASTA or plain DNA, up to 1 MiB | Conditional | Required when Thrifty correction is enabled for heavy or combined scoring. Must contain only A, C, G, and T and translate exactly to the resolved heavy-chain consensus. |
| Light-chain coding sequence | FASTA or plain DNA, up to 1 MiB | Conditional | Required when Thrifty correction is enabled for light or combined scoring. Must contain only A, C, G, and T and translate exactly to the resolved light-chain consensus. |
The default DMS column names are heavy, light, and fitness. Map different column names in DMS column mapping. CoSiNE derives the wild-type heavy and light consensus site by site unless you provide explicit consensus sequences.
Column names are case-sensitive, so a header of Heavy does not match the default mapping heavy. Every row needs a non-empty heavy sequence, light sequence, and fitness value, and the fitness value must be numeric. One blank cell or an entry such as ND rejects the whole table rather than skipping that row, so remove or fill such rows before upload. A row with more fields than the header is also rejected, so quote any value that contains a comma.
Within each chain column, all sequences must have the same length. Trim or align every sequence to the same variable-domain span first, and use only the 20 canonical amino-acid letters, because residue codes outside that alphabet cannot be embedded by the model.
Coding DNA for Thrifty correction must be uppercase A, C, G, and T, a single record, and made of complete codons. Lowercase output from some sequence viewers is rejected, so convert it first. If the translation does not match the consensus, check that the DNA covers exactly the residues in the table, with no signal peptide or constant-region codons, and that an explicit consensus matches the same span.
| Input | Format | Required | Requirements |
|---|---|---|---|
| Starting antibody sequence | FASTA or plain protein, up to 1 MiB | No | One heavy-chain variable-domain sequence using the 20 canonical amino acids. When omitted, CoSiNE selects a source-provided binder using Built-in binder index. |
Antibody evolution is not currently executable because its required source checkpoint is unpublished.
| Parameter | Options | Default | Description |
|---|---|---|---|
| Task | Antibody evolution, Variant effect prediction | Antibody evolution | Selects the input form, settings, and outputs. Choose Variant effect prediction for the currently runnable workflow. |
| Parameter | Type | Default | Description |
|---|---|---|---|
| CoSiNE branch lengths | Comma-separated non-negative numbers | 0.2 | Evaluates every requested CTMC branch length and adds ll_<t> and ppl_<t> columns. |
| Scoring axes | One or more of heavy, light, combined | heavy, light | Scores variants with mutations on the selected chain or on the paired heavy-light sequence. |
| Use paired heavy-light context | Boolean | true | For heavy or light, supplies both wild-type chains as context while changing the selected chain. combined always uses both chains. |
| Apply Thrifty SHM correction | Boolean | true | Subtracts a neutral somatic-hypermutation log-likelihood from the CoSiNE log-likelihood. Requires coding DNA for every selected chain. |
| Thrifty branch lengths | Comma-separated non-negative numbers | 0.2 | Evaluates every requested neutral SHM branch length and adds corrected_ll_<t>_<bl> columns. Visible when correction is enabled. |
| Correlation method | Spearman, Pearson | Spearman | Correlates each score column with the submitted experimental fitness values. |
| Log-transform experimental fitness | Boolean | false | Applies the natural logarithm to fitness before correlation. Use only when every analyzed fitness value is positive and the assay scale justifies the transform. |
| Parameter | Default | Description |
|---|---|---|
| Heavy-chain column | heavy | CSV column containing aligned-length heavy-chain amino-acid sequences. |
| Light-chain column | light | CSV column containing aligned-length light-chain amino-acid sequences. |
| Experimental fitness column | fitness | CSV column containing numeric assay values. |
| Heavy mutation column | Empty | Optional precomputed heavy-chain mutation labels, such as A23V or A23V,T45G. When empty, labels are derived from the sequences. |
| Light mutation column | Empty | Optional precomputed light-chain mutation labels. When empty, labels are derived from the sequences. |
| Heavy-chain consensus | Empty | Optional explicit wild-type heavy-chain amino-acid sequence. When empty, CoSiNE resolves a site-by-site consensus from the table. |
| Light-chain consensus | Empty | Optional explicit wild-type light-chain amino-acid sequence. When empty, CoSiNE resolves a site-by-site consensus from the table. |
These settings reproduce the source evolution interface, but evolution jobs remain unavailable until the required binding-predictor checkpoint can be verified.
| Parameter | Type | Default | Description |
|---|---|---|---|
| Sampling method | Unguided Gillespie, Guided Gillespie (TAG) | Unguided Gillespie | Uses unconditional sampling or predictor-guided sampling. |
| Binding predictor | SARS-CoV-2 Beta RBD, SARS-CoV-1 RBD | SARS-CoV-2 Beta RBD | Chooses the source predictor used for guided sampling and native fitness columns. |
| Built-in binder index | Integer, minimum 0 | 0 | Zero-indexed binder selected from the chosen predictor dataset when no starting sequence is supplied. |
| Branch length | Number, minimum 0 | 2 | Evolutionary time calibrated to the expected number of mutations per site. |
| Number of trajectories | Integer, minimum 1 | 100 | Number of sampled evolutionary trajectories. |
| Use discrete mutation steps | Boolean | false | Uses Maximum mutations as the discrete Gillespie step count instead of continuous branch time. |
| Maximum mutations | Integer, minimum 1 | Empty | Optional mutation ceiling in continuous mode and required step count in discrete mode. |
| Mutable region | All positions, CDR1, CDR2, CDR3, All CDRs, Framework 1, Framework 2, Framework 3, Framework 4, All framework regions | All positions | Restricts changes to the selected IMGT-numbered region. |
| Guidance strength | Number | 2 | Predictor-guidance strength. Visible only for guided sampling. |
| Random seed | Integer from 0 to 2147483647 | Empty | Reproduces sampled trajectories when set. An empty value uses the source timestamp seed. |
| Artifact | Format | Description |
|---|---|---|
| Axis result tables | CSV | cosine_vep_heavy.csv, cosine_vep_light.csv, and/or cosine_vep_combined.csv, one for each selected axis. They preserve source row order and include the submitted columns, mutation labels, raw scores, and optional corrected scores. |
| Raw correlations | CSV | cosine_correlations.csv with chain, metric, correlation, p_value, and n_samples. |
| Selection-score correlations | CSV | cosine_selection_correlations.csv, returned when SHM correction is enabled, with one row per chain and correction branch length and one column per CoSiNE branch length. |
| Submitted DMS table | CSV | submitted_dms.csv, preserved unchanged. |
| Source log | TXT | cosine_source.log with captured source diagnostics. |
| Provenance | JSON | cosine_provenance.json with pinned source, model, compatibility, and resolved-setting details. |
When evolution becomes available, its interface returns the native evolution table as cosine_evolution.source.csv, a derived cosine_evolved_sequences.fasta, and cosine_source.log. Planned table fields include the seed and sampled sequences, branch length, guidance type, mutation count, trajectory index, timing, predictor fitness, humanness metrics, and edit distance from the seed. No evolution result is produced while the required source checkpoint is unavailable.
mutation identifies the amino-acid substitutions scored on that axis. Combined labels join heavy and light mutations with |.ll_<t> is the summed CoSiNE log-likelihood for the wild-type-to-variant transition at branch length t. Within the same axis, context, and branch length, a higher value means the model assigns the transition greater likelihood.ppl_<t> is exp(-ll / sequence length). Lower values indicate lower per-residue surprise. Because sequence length and context affect the calculation, compare perplexity within a consistent scoring setup.corrected_ll_<t>_<bl> is the CoSiNE log-likelihood minus the Thrifty neutral SHM log-likelihood. It is a model-derived selection score, not a measured affinity or binding constant.correlation is the selected Spearman or Pearson association between one score column and the submitted fitness values. Its sign depends on the metric: likelihood-based scores and perplexity point in opposite numerical directions.p_value and n_samples describe that correlation calculation. They do not provide a universal model confidence score.Use CoSiNE scores to prioritize and compare variants within a controlled assay and scoring protocol. Confirm candidates with binding, expression, developability, and other relevant experiments.
CoSiNE runs zero-shot, so nothing is fitted to the submitted assay, and a correlation measures how well one setup happens to agree with one table. A correlation needs at least two non-missing samples, and values from a small library move substantially with a few rows. A single p_value does not validate the workflow, because each branch length, axis, and metric produces another correlation to choose from.
The combined axis scores the joint heavy-light transition directly, so its values are not the sum of the heavy and light values. Axes, paired-context choices, and branch lengths also change the scale, so rank variants within one fixed setup rather than comparing raw magnitudes across files.
For a perplexity column, a negative correlation with fitness is the expected direction when higher fitness is better, because lower perplexity marks a more likely transition. For ll_<t> and corrected_ll_<t>_<bl>, the expected direction is positive.
Before interpreting scores, confirm that heavy and light sequences are assigned to the correct row, that the chain orientation and domain boundaries are right, and that the fitness values are normalized consistently across replicates. A shifted row or swapped chain can produce a convincing but meaningless correlation.
To test sensitivity, request a small set of branch lengths in one job, such as 0.1,0.2,0.4, and compare the paired and single-chain context settings. The quote does not change with the number of branch lengths, so this costs nothing extra. Decide which setup to report before looking at the correlations, and prefer variant rankings that stay stable across the checks over one optimized coefficient.
A correlation on the library used to choose settings is not evidence of predictive performance. Use held-out variants or an independent library for that, then retest shortlisted variants experimentally.
Humanize antibody sequences and evaluate humanness scores for therapeutic development.
Design antibody CDRs with Proteo-R1 reasoning, diffusion, and optional framework inpainting.
Design antibody and nanobody binders with an end-to-end RosettaCommons pipeline
Design protein, peptide, and nanobody binders against protein or small-molecule targets.
Design antibody CDR regions using equivariant diffusion models for de novo antibody engineering
Family-conditioned protein sequence generation from FASTA, A2M, or A3M input
Generate protein sequences de novo, scaffold fixed motifs, or inpaint selected regions.
All-atom SE(3)-equivariant diffusion for unconditional generation, motif scaffolding, and binder design.
Generate novel drug-like molecules using NVIDIA's discrete diffusion AI model.
Design all-atom protein binders with controlled target sites, lengths, and interaction parameters.
Antibody evolution is awaiting a published source asset