HomeTutorials › Installation

Installation & Setup

Get OmicsAgent.ai running in under 10 minutes. All 15 skills work with no API key needed for demo mode.

Prerequisites

RequirementMinimumRecommended
Python3.103.11 or 3.12
RAM8 GB16 GB+
OSLinux / macOS / WSL2Ubuntu 22.04 / macOS 14
Anthropic API keyChat mode onlyconsole.anthropic.com
No API key needed for demo mode. All 15 skills run locally with synthetic PBMC data.

Option A — Conda (recommended)

conda create -n omicsagent python=3.11 -y
conda activate omicsagent
git clone https://github.com/madhubioinformatics/OmicsAgent
cd OmicsAgent
pip install -r requirements.txt

Option B — pip + venv

python3 -m venv .venv && source .venv/bin/activate
git clone https://github.com/madhubioinformatics/OmicsAgent
cd OmicsAgent
pip install -r requirements.txt

Option C — Docker

docker pull madhubioinformatics/omicsagent:latest
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  madhubioinformatics/omicsagent python3 omics_agent.py --demo

Set API Key

# Temporary (current session)
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# Permanent (.env file)
echo 'ANTHROPIC_API_KEY=sk-ant-api03-...' > .env

Verify Installation

python3 omics_agent.py --list

# Expected output:
  o  genomics           Genomics (WGS/WES/SNP)
  o  scrna              scRNA-seq (Single-cell)
  o  scatac             scATAC-seq (ChromVAR / LSI)
  o  spatial_full       Spatial (Visium/MERFISH/CosMx/Stereo-seq)
  o  scTCR_BCR          scTCR/BCR-seq (Immune Repertoire)
  ... 10 more skills

Next Steps

1

Generate PBMC demo data

Run python3 data/pbmc_demo_generator.py to create 8 synthetic PBMC data layers.

2

Run the full demo

Run python3 omics_agent.py --demo — all 15 skills complete in ~80 seconds.

3

Try chat mode

Run python3 omics_agent.py --chat and describe your analysis in plain English.

Next: PBMC Demo →