geniml

Build machine learning embeddings from genomic interval BED files.

783|65|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/LeonChaoX/qinyan-academic-skills --skill geniml-leonchaox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geniml
Source: https://github.com/LeonChaoX/qinyan-academic-skills/tree/main/skills/05-%E7%94%9F%E7%89%A9%E4%BF%A1%E6%81%AF%E4%B8%8E%E5%9F%BA%E5%9B%A0%E7%BB%84%E5%AD%A6/geniml
Command: npx skills add https://github.com/LeonChaoX/qinyan-academic-skills --skill geniml-leonchaox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Genomic interval machine learning turns BED-region collections into useful vector representations so you can perform similarity search, clustering, and other ML tasks without hand-engineering features for peaks and single-cell chromatin accessibility.

Core Features & Use Cases

  • Region2Vec: Learn unsupervised embeddings of genomic regions from tokenized BED intervals for region similarity and downstream ML features.
  • BEDspace: Train joint embeddings for region sets and metadata labels (via StarSpace) to enable metadata-aware searches across regions and experimental conditions.
  • scEmbed: Generate cell-level embeddings for single-cell ATAC-seq (scATAC-seq) to support clustering, annotation, and scanpy workflows.
  • Consensus peaks (universes): Build standardized reference peak sets from multiple BED files to define a consistent vocabulary for tokenization.
  • Utilities: Support caching (BBClient), null-model randomization (BEDshift), embedding evaluation, and region tokenization/search backends.

Use case example: You have multiple ATAC-seq BED files and want a shared peak vocabulary plus region embeddings; you then build a universe from the BED collection, tokenize regions against that universe, and train Region2Vec (or scEmbed for single-cell) to cluster similar regulatory regions across experiments.

Quick Start

Use the geniml skill to train genomic region embeddings from your BED files by building a consensus universe, tokenizing into a model-ready format, and running the appropriate Region2Vec or scEmbed training pipeline from the provided references.

Frequently Asked Questions about geniml

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

FAQPage Schema
How do I generate machine learning embeddings from genomic BED interval files?

To generate genomic interval embeddings from BED files, you first build a consensus peak universe to define a shared vocabulary, tokenize the regions against it, and then train an unsupervised model like Region2Vec to produce vector representations for downstream ML tasks.

Can I create cell-level embeddings for single-cell ATAC-seq data using BED files?

Yes, you can generate cell-level embeddings for single-cell ATAC-seq data by using the scEmbed pipeline, which supports clustering, annotation, and integration with scanpy workflows for chromatin accessibility analysis.

What is a consensus peak universe and when do I need it for genomic region tokenization?

A consensus peak universe is a standardized reference peak set built from multiple BED files to define a consistent vocabulary. You need it to tokenize genomic regions into a model-ready format before training region embeddings.

How do I train joint embeddings for genomic region sets and experimental metadata labels?

You can train joint embeddings for region sets and metadata labels using the BEDspace pipeline, which leverages StarSpace to enable metadata-aware similarity searches across genomic regions and experimental conditions.

Do I need pre-processed BED files or raw genomic data to start learning region embeddings?

You need pre-processed BED files representing genomic intervals as input. The workflow requires these BED files to build a consensus universe and tokenize regions before initiating the machine learning training flows for embeddings.

What utilities are available for evaluating genomic region embeddings and generating null models?

Available utilities include BEDshift for null-model randomization, caching via BBClient, embedding evaluation tools, and region tokenization or search backends to validate and manage your genomic interval machine learning workflows.