alterlab-geniml

Build unsupervised embeddings from genomic interval data with Geniml.

58|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-geniml
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: alterlab-geniml
Source: https://github.com/AlterLab-IEU/AlterLab-Academic-Skills/tree/main/skills/domain-specific/alterlab-geniml
Command: npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-geniml

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Geniml brings a complete toolkit to build unsupervised embeddings from genomic interval data, enabling similarity searches, clustering, and downstream ML analyses across BED files, scATAC-seq data, and consensus peak sets.

Core Features & Use Cases

  • Region2Vec: learn embeddings for genomic regions to reduce dimensionality and enable region-level analyses.
  • BEDspace: jointly embed regions and metadata labels for metadata-aware searches across regions and labels.
  • scEmbed: generate cell embeddings from scATAC-seq data for clustering and annotation.
  • Universe building: construct consensus peak universes to standardize tokenization references.
  • Utilities: caching, randomization, evaluation, tokenization, and search backends for reproducible pipelines.

Use cases include clustering cells, performing similarity queries across datasets, and building tokenization universes for cross-project analyses.

Quick Start

Run Geniml with a prepared universe and tokenized BED files to train embeddings and evaluate them on a sample metadata file.

Frequently Asked Questions about alterlab-geniml

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

FAQPage Schema
How do I generate genomic embeddings from BED files for clustering?▼

To generate genomic embeddings from BED files, you need a prepared universe BED file for tokenization. Once tokenized, you can train unsupervised embeddings to reduce dimensionality and enable region-level clustering and similarity searches.

What is Region2Vec and how does it work for genomic interval data?▼

Region2Vec is an embedding technique that learns vector representations for genomic regions from interval data. It reduces dimensionality to enable region-level analyses, similarity queries, and downstream machine learning tasks across BED files.

Can I embed scATAC-seq data for single-cell clustering and annotation?▼

Yes, you can embed scATAC-seq data using the scEmbed workflow. It generates cell embeddings from single-cell genomic interval data, enabling unsupervised clustering and cell annotation across scATAC-seq datasets.

Do I need a universe bed file to tokenize genomic intervals?▼

Yes, a universe BED file is required as a technical prerequisite for tokenization. It acts as a consensus peak reference to standardize genomic intervals before training embeddings and evaluating metadata.

What's the best way to perform metadata-aware similarity searches across genomic regions?▼

The BEDspace workflow jointly embeds genomic regions and metadata labels for metadata-aware searches. This approach enables similarity queries across both regions and associated labels within bulk and single-cell datasets.

How do I build a consensus peak universe to standardize tokenization references?▼

Universe building constructs consensus peak sets from genomic interval data to standardize tokenization references. This process creates a unified BED file required for cross-project tokenization and reproducible embedding pipelines.