Installation

Prerequisites

  • python>=3.12
  • pip or uv

1) Install

Run the following to install the CLI:

pip install metahq-cli

Install from Source

Clone the repository

git clone https://github.com/krishnanlab/meta-hq.git
cd meta-hq


Install packages

Some make commands require uv (e.g., make uv_install or make uv_dev). These will automatically create a uv venv. Run source .venv/bin/activate to activate it.

We recommend using the uv package manager to install MetaHQ. It is a modern, simple, and fast Rust-based package manager. See the following link to install uv: https://docs.astral.sh/uv/getting-started/installation

With make:

Install through uv: 

make uv_install

Install through pip: 

make install

Manually:

Install through pip: 

pip install packages/core packages/cli

# or from a tar build
pip install metahq_core-1.1.0.tar.gz metahq_cli-1.1.1.tar.gz

2) Download the Database

Download the MetaHQ database. See the the setup guide for more details.

metahq setup