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.