Instructions to use HazemLab/ares-expert-choice-4b-interleaved-150K with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use HazemLab/ares-expert-choice-4b-interleaved-150K with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("fill-mask", model="HazemLab/ares-expert-choice-4b-interleaved-150K", trust_remote_code=True)# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("HazemLab/ares-expert-choice-4b-interleaved-150K", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
ares-expert-choice-4b-interleaved-150K
A ~4.22B-parameter sparse Mixture-of-Experts protein language model, pretrained from scratch on UniRef50 with a masked-language-modeling objective on TPU.
This is the expert choice variant, with MoE feed-forwards on every other layer, alternating with dense ones (interleaved placement), taken at 150,000 training steps.
Spotlight at the GenBio Workshop, ICML 2026. Ares: Loss-Free Mixture-of-Experts Routing for Bidirectional Protein Encoders.
Pick the right checkpoint
Five Ares checkpoints are published. They share an architecture and a training recipe and differ only in how tokens reach experts and where the MoE layers sit.
| Checkpoint | Routing | MoE placement | Steps | ProteinGym |
|---|---|---|---|---|
ares-softmoe-4b-consecutive-150K |
Soft | Consecutive | 150,000 | 0.341 |
ares-softmoe-4b-l2-consecutive-225K |
Soft + L2 | Consecutive | 225,000 | 0.341 |
ares-softmoe-4b-l2-consecutive-150K |
Soft + L2 | Consecutive | 150,000 | 0.319 |
ares-expert-choice-4b-interleaved-150K ← you are here |
Expert choice | Interleaved | 150,000 | 0.126 |
ares-ec-moe-4b-86k |
Expert choice | Consecutive | 86,000 | not evaluated |
ProteinGym numbers are the Fisher-z aggregated Spearman over 217 DMS substitution assays (see Evaluation). Higher is better.
If you just want a protein encoder, start with
ares-softmoe-4b-consecutive-150K.
It and ares-softmoe-4b-l2-consecutive-225K
are the two strongest of the family and are effectively tied on ProteinGym (0.341 vs 0.341;
they split the 217 assays 111 to 106). The 150K checkpoint is the simpler default: same
score, fewer training steps, no router normalization to reason about.
Model details
| Parameters | 4,215,708,704 (~4.22B) |
| Weights on disk | ~16.9 GB, float32, single model.safetensors |
| Layers | 20 encoder blocks, pre-norm |
| Hidden size | 1024 |
| Feed-forward size | 4096, gated SiLU (SwiGLU) |
| Attention | Grouped-query, 16 heads / 8 KV heads, head dim 64 |
| Position encoding | Rotary (RoPE), base 10000 |
| Normalization | RMSNorm |
| Vocabulary | 31 tokens (20 standard + BXZJUO + 5 special) |
| Trained context | 1024 tokens |
| Experts | 32 |
| Routing | expert_choice |
| MoE placement | Interleaved (odd layers 1, 3, ..., 19) |
| Objective | Masked language modeling with scheduled masking + mutation noising |
How routing works here
Each of the 32 experts selects its own top-k tokens, with k set by a capacity factor of 2.0 over the flattened batch. Load is balanced by construction (every expert receives exactly the same number of tokens), but tokens can be dropped entirely or picked by several experts at once.
Compute cost
~0.44B active parameters per token. A capacity factor of 2.0 across 32 experts means roughly 2 experts of work per token, so about 0.44B of the 4.22B parameters are exercised on any given token. The exact figure varies per token: expert choice makes no guarantee that a token is picked at all.
Usage
Ares is not part of transformers, so install the ares package first. It provides the
Ares model class and the tokenizer, and no trust_remote_code is needed.
pip install git+https://github.com/hazemessamm/ares.git
Only the core dependencies are required for inference; the training and evaluation extras are never imported on the model path.
Fill in masked residues
import torch
from ares import Ares, AresProteinTokenizer
model = Ares.from_pretrained("HazemLab/ares-expert-choice-4b-interleaved-150K", dtype=torch.bfloat16).eval()
tokenizer = AresProteinTokenizer()
sequence = "MKTAYIAKQRQISFVKSHFSRQ<mask>ERLEKLLQ"
batch = tokenizer(sequence, return_tensors="pt")
with torch.no_grad():
logits = model(**batch).logits
mask_pos = (batch["input_ids"] == tokenizer.mask_token_id).nonzero()[0, 1]
top = logits[0, mask_pos].topk(5)
for score, token_id in zip(top.values, top.indices):
print(tokenizer.decode(token_id), float(score))
Extract residue and sequence embeddings
hidden_states[0] holds the final normalized representation.
with torch.no_grad():
out = model(**batch)
residue = out.hidden_states[0] # (batch, length, 1024)
mask = batch["attention_mask"].unsqueeze(-1)
pooled = (residue * mask).sum(1) / mask.sum(1) # (batch, 1024), mean-pooled
Both the <cls> token and mean pooling over unpadded positions are reasonable sequence
representations; the downstream evaluations in the repository use mean pooling.
Notes on loading
- Weights are stored in float32 (~17 GB). Pass
dtype=torch.bfloat16unless you specifically need float32; every evaluation in the paper was run in bfloat16. AresProteinTokenizerbuilds its vocabulary in code, so it needs no download and is identical across every Ares checkpoint.- This repo ships no tokenizer files, and does not need any: the tokenizer is constructed in code.
- The model accepts an optional
sequence_idsargument for block-diagonal attention over packed sequences. Leave it unset for ordinary batched inference.
Training
| Data | UniRef50 (agemagician/uniref50_09012025), 68,346,946 sequences |
| Steps | 150,000 optimizer steps |
| Objective | MLM, masking rate cycled over 0.15 / 0.20 / 0.25 / 0.30 |
| Corruption | 80% <mask>, 10% random-residue mutation, 10% unchanged |
| Masking schedule | staged_linear, starting at 15% masking and progressively mixing in the higher rates |
| Optimizer | AdamW, lr 3e-4, betas (0.9, 0.95), eps 1e-8, weight decay 0.01 |
| Schedule | 5% warmup, gradient clipping at 1.0 |
| Precision | bfloat16 autocast, float32 master weights |
| Sequence handling | Multiple sequences packed per batch row with block-diagonal attention masking and per-sequence position IDs |
| Hardware | Google Cloud TPU via PyTorch/XLA with SPMD sharding, gradient checkpointing enabled |
Sequence packing means no compute is spent on padding. Correctness of packed training
against unpacked inference is asserted in the repository's
tests/test_packing_correctness.py.
Evaluation
ProteinGym (zero-shot DMS substitutions)
Spearman correlation between masked-marginal likelihood scores and measured fitness, over 217 DMS substitution assays spanning 200 UniProt entries. Scores are aggregated per UniProt entry and then per selection type, both arithmetically and under a Fisher-z transform. Inference ran in bfloat16 with no length cutoff.
| Aggregation | Activity | Binding | Expression | OrganismalFitness | Stability | All |
|---|---|---|---|---|---|---|
| Standard | 0.139 | 0.134 | 0.176 | 0.107 | 0.065 | 0.124 |
| Fisher-z | 0.140 | 0.135 | 0.179 | 0.109 | 0.067 | 0.126 |
Against the rest of the family and public baselines
Same protocol, same 217 assays, Fisher-z aggregation:
| Model | Spearman (Fisher-z) |
|---|---|
ElnaggarLab/ankh-large |
0.393 |
ares-softmoe-4b-consecutive-150K |
0.341 |
ares-softmoe-4b-l2-consecutive-225K |
0.341 |
ares-softmoe-4b-l2-consecutive-150K |
0.319 |
ElnaggarLab/ankh-base |
0.270 |
ares-expert-choice-4b-interleaved-150K |
0.126 |
Per-assay and per-UniProt breakdowns for every row above are checked into the repository
under evaluation/proteingym_results/.
Downstream tasks
The repository also provides fine-tuning and frozen-embedding evaluations for GB1 epistasis,
fluorescence, stability, remote homology, 3- and 8-state secondary structure, and subcellular
localization. Those scripts live in
evaluation/; results are not
included in this model card.
Limitations and known issues
- Encoder only. This is a bidirectional masked LM. It scores and embeds sequences; it does not generate them autoregressively.
- 1024-token training context. RoPE allows longer inputs to run, but nothing beyond 1024 residues was seen during training and quality past that point is untested.
- Single-chain amino acid sequences. No structure, no MSA, no multimer or nucleotide input.
- Weights are float32. Expect a ~17 GB download and load in bfloat16 for inference.
- UniRef50 inherits the biases of the sequence databases it was built from. Well-studied organisms and protein families are heavily over-represented. Zero-shot variant-effect performance varies sharply by assay type; the per-assay CSVs in the repository make this visible.
- The expert-choice router is not faithful to the original formulation. Its routing softmax normalizes over tokens rather than over experts, which changes what the router probabilities mean and what gradient the router receives. This is a known defect, and it is the most likely explanation for the gap between the expert-choice and soft-routing checkpoints. Treat this checkpoint as a research artifact for studying that failure mode rather than as a production encoder.
- Tokens can be dropped. With a capacity factor of 2.0, expert choice offers no guarantee that any particular token is selected by any expert. Dropped tokens pass through the MoE layer with a zero contribution from the feed-forward path.
moe_num_slotsappears inconfig.jsonbut is inert for expert-choice routing; it only affects the soft router.- This checkpoint scores poorly on ProteinGym (0.126 Fisher-z, against 0.341 for the soft-routing sibling trained for the same 150,000 steps). It is published for reproducibility and for the MoE interpretability work, not as a recommended encoder.
- Not validated for clinical, diagnostic, or biosafety-relevant decisions. Variant-effect predictions from this model are hypotheses for experimental follow-up, nothing more.
MoE interpretability
Ares ships an analysis pipeline for inspecting what the experts in these checkpoints
actually do: per-expert amino-acid and biochemical-property preferences, positional
preferences, routing heatmaps, causal expert-knockout importance, and steering
interventions. See
evaluation/moe_analysis/
and read
ANALYSIS_OUTPUTS.md
before interpreting any specialization number. It documents every artifact, every metric,
and the axis each routing weight normalizes over.
Citation
@inproceedings{alsamkary2026ares,
title = {Ares: Loss-Free Mixture-of-Experts Routing for Bidirectional Protein Encoders},
author = {Alsamkary, Hazem},
booktitle = {ICML 2026 Workshop on Generative AI and Biology (GenBio)},
year = {2026},
note = {Spotlight},
url = {https://openreview.net/forum?id=gq0R7xiPjg}
}
Not the final version; it will be updated when the camera-ready lands.
License
MIT.
Affiliation: Proteinea.
- Downloads last month
- 23