YAML Metadata Warning:empty or missing yaml metadata in repo card
Check out the documentation for more information.
UniGenX
Unified autoregressive generation of 3D atomic structures — crystals, molecules, proteins, and protein-ligand complexes — with a single Llama decoder that jointly models discrete tokens and continuous 3D coordinates.
UniGenX represents a structure as one sequence that interleaves discrete tokens (element / residue symbols and special tokens) with continuous coordinate slots. At each step the standard LM head predicts the next token, while a diffusion head samples the (x, y, z) coordinate at every position flagged by a coordinate mask. One forward pass therefore produces both the sequence and its geometry.
Pretrained checkpoints
| Task | Checkpoint family |
|---|---|
| Unified crystal + molecule | unified_{carbon24,mp20,mpts52,qm9}; unified_pretrain (backbone) |
| Crystal structure prediction | csp_{carbon24,mp20,mpts52}; csp_pretrain (backbone) |
| Material multi-property design | mc_mat, bs_mat_1..6, ms_mat_1..6 |
| Molecular conformers | mol_qm9, mol_drugs |
| Conditional molecules | c_mol |
| Proteins (MD) | 1_m_p..12_m_p |
| Proteins (structure prediction) | b_p, e_bs, e_wo_bs |
| Protein-ligand docking | pld, pld_u |
| Enzyme / EC design | e, e_wo |
Pre-training backbones. csp_pretrain and unified_pretrain are
fine-tuning starting points, not per-benchmark evaluation checkpoints, and
neither reproduces a specific paper table row on its own. unified_pretrain
carries saved args and loads through unigenx_infer.py; csp_pretrain has
no saved args and cannot be driven through unigenx_infer.py as-is — train
/ fine-tune from it first.
Abbreviation Dictionary
c - Conditional
mc - Multi-Conditional
b - base
bs - conditional on bulk
ms - conditional on mag
wo - without structure
1_m to 12_m - 1FME,2F4K,2JOF,2WAV,A3D,CLN025,GTT,NTL9,NuG2,PRB,UVF,lambda (leave-one-out)
mat - material
p - protein
mol - molecules
Citation
If you use UniGenX, please cite the paper.
@article{zhang2025unigenx,
title={UniGenX: unified generation of sequence and structure with autoregressive diffusion},
author={Zhang, Gongbo and Li, Yanting and Luo, Renqian and Hu, Pipi and Zhao, Zeru and Li, Lingbo and Liu, Guoqing and Wang, Zun and Bi, Ran and Gao, Kaiyuan and others},
journal={arXiv e-prints},
pages={arXiv--2503},
year={2025}
}
License
Released under the MIT License; see LICENSE.