Skip to content

yangheng95/OmniGenBench

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

favicon.png

OmniGenBench is a modular benchmarking platform for evaluating genomic foundation models (GFMs) across diverse tasks like RNA structure prediction, gene function classification, and multi-species generalization.

🔍 What You Can Do with OmniGenBench?

  • 🧬 Benchmark effortlessly — Run automated and reproducible evaluations for genomic foundation models
  • 🧠 Understand your models — Explore interpretability across diverse tasks and species
  • ⚙️ Run tutorials instantly — Use click-to-run guides for genomic sequence modeling
  • 🚀 Train and infer efficiently — Accelerated workflows for training and inference on GFMs

Installation

Requirements

Before installing OmniGenome, you need to install the following dependencies:

  • Python 3.10+
  • PyTorch 2.5+
  • Transformers 4.46.0+

PyPI Installation

To install OmniGenome, you can use pip:

pip install omnigenome -U

Source Installation

Or you can clone the repository and install it from source:

git clone [https://github.com/yangheng95/OmniGenBench.git](https://github.com/yangheng95/OmniGenBench.git)
cd OmniGenBench
pip install -e .

Quick Start

Auto-benchmark via CLI

The following command will download the model from the Hugging Face model hub and run the benchmark on the RGB benchmark:

autobench --model_name_or_path "yangheng/OmniGenome-186M" --benchmark "RGB" --trainer accelerate

You can find a visualization of AutoBench here.

Auto-benchmark via Python API

Or you can use the following python code to run the auto-benchmark:

from omnigenome import AutoBench
gfm = 'LongSafari/hyenadna-medium-160k-seqlen-hf'
# benchmark could be "RGB", "GB", "PGB", "GUE", which will be downloaded from the Hugging Face model hub
benchmark = "RGB"
bench_size = 8
seeds = [0, 1, 2, 3, 4]
bench = AutoBench(benchmark=benchmark, model_name_or_path=gfm, overwrite=False)
bench.run(autocast=False, batch_size=bench_size, seeds=seeds)

You can find an example of AutoBench via Python API here.

Tutorials

RNA Design

RNA design is a fundamental problem in synthetic biology, where the goal is to design RNA sequences that fold into a target structure. In this demo, we show how to use OmniGenome to design RNA sequences that fold into a target structure using a pre-trained model. The tutorials of RNA Design Demo can be found in RNA_Design_Tutorial.ipynb.

You can find a visual example of RNA Design here.

RNA Secondary Structure Prediction

RNA secondary structure prediction is a fundamental problem in computational biology, where the goal is to predict the secondary structure of an RNA sequence. In this demo, we show how to use OmniGenome to predict the secondary structure of RNA sequences using a pre-trained model. The tutorials of RNA Secondary Structure Prediction can be found in Secondary_Structure_Prediction_Tutorial.ipynb.

You can find a visual example of RNA Secondary Structure Prediction here.

More Tutorials

Please find more usage tutorials in examples/tutorials.

Citation

@article{yang2024omnigenbench,
      title={OmniGenBench: A Modular Platform for Reproducible Genomic Foundation Models Benchmarking}, 
      author={Heng Yang and Jack Cole, Yuan Li, Renzhi Chen, Geyong Min and Ke Li},
      year={2024},
      eprint={[https://arxiv.org/abs/2505.14402](https://arxiv.org/abs/2505.14402)},
      archivePrefix={arXiv},
      primaryClass={q-bio.GN},
      url={[https://arxiv.org/abs/https://arxiv.org/abs/2505.14402](https://arxiv.org/abs/https://arxiv.org/abs/2505.14402)}, 
}

License

OmniGenomeBench is licensed under the Apache License 2.0. See the LICENSE file for more information.

Contribution

We welcome contributions to OmniGenomeBench! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request on GitHub.

About

Provide RNA and DNA Foundation Model Benchmarks and Applications

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages