Skip to content

Refgenie

Software for reference genome data management.

Alpha

Refgenie 1.0 is an alpha. It works, but commands and data can still change, so pin the version in production pipelines. See what's new.

Refgenie downloads pre-built reference genome files by name, such as FASTA files and bwa, bowtie2 and hisat2 indexes, and prints their local paths for your pipelines. It builds the same files for any other genome. It gives each genome an ID computed from its sequences, so a mismatched reference gets caught.

Terminal window
pip install "refgenie>=1.0.0a3" # without the version, pip gives the old 0.13
refgenie init
refgenie pull hg38/fasta_index # about 12 KB
refgenie seek hg38/fasta_index.chrom_sizes # prints the local path

Using an AI assistant? Paste this into it. To connect the MCP server too, see Use refgenie with AI.

Read https://docs.refgenie.org/SKILL.md, then use refgenie to help me with reference genome data: download and build genome assets (indexes, sequences), find asset paths for my pipelines, and work with the genomes I have.