Repository navigation
Pre-release (beta) of eggNOG-mapper v3, targeting the eggNOG 7 database.
Not compatible with eggNOG 5 data. For testing — please report issues.
⚠️ Breaking changes
- Annotations output reduced 25 → 22 columns. Dropped
Description,max_annot_lvl,
farthest_donor_taxid; columns regrouped into mapping / context / sources blocks.
Retained values are unchanged. annotation_confidenceis now a compact positional code — one character per
functional field (h=high,m=medium,l=low,-=none), with a decode legend
written into the output header. Update any parser that split onfield=tier;.- CLI cleanup: removed
--db,--translate(translation is automatic now),
--mp_start_method,--unsorted_seeds, and HMMER as a search mode. DIAMOND flags
renamed to--dmnd_*;--seed_ortholog_evalue/score→--annot_evalue/--annot_score.
Highlights
- eggNOG 7 integer-encoded orthology (~59M proteins), curated-only annotation
donors, and a per-seed taxonomic ceiling (--tax_scope auto). - Faster at scale: seed sorting + de-duplication and a lazy closest-cascade are
on by default (byte-identical output). --selftest— verify an installation end-to-end in one command.- Prebuilt caches ship with the DB (field-presence mask + taxid cache) → no
~50-min first-run build. - MAJOR.MINOR data layout (
emapper-3.0/): the whole3.0.xseries reuses the
same databases; re-download only on a minor bump. - Optional MMseqs2 v7 database;
--resumenow guards against output-schema drift. - Self-contained Apptainer image bundling DIAMOND, MMseqs2, HMMER and Prodigal.
Getting started
pip install . # or use the Apptainer image
python download_eggnog_data.py -y --data_dir DATA
emapper.py --selftest # verify the install
emapper.py -i proteins.fa -o run --data_dir DATA --cpu 8- Free web service (no install): https://eggnog-mapper.cgmlab.org
- Databases & Apptainer images: https://data.cgmlab.org/eggnog-mapper/
- Full manual: USAGE.md · Complete changelog: CHANGELOG.md
Notes:
- The [USAGE.md]/[CHANGELOG.md] links resolve on the release page once main + the tag are pushed.
- If you'd rather have the exhaustive list, tick "Generate release notes" in the web UI (auto-diff from commits) or paste the
[3.0.0-beta6] section from CHANGELOG.md. - Set the tag to v3.0.0-beta6 and target main.