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.