Skip to content

eggNOG-mapper v3.0.0-beta6

Latest

Choose a tag to compare

@jhcepas jhcepas released this 13 Aug 18:40

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_confidence is 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 on field=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 whole 3.0.x series reuses the
    same databases; re-download only on a minor bump.
  • Optional MMseqs2 v7 database; --resume now 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

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.