TaxonoPy

A Python package for efficiently aligning organismal taxonomic hierarchies using the Global Names Verifier.
https://github.com/imageomics/taxonopy

Category: Biosphere
Sub Category: Biodiversity Analysis and Metrics

Keywords

alignment hierarchy taxonomic-resolution taxonomy tree-of-life

Last synced: about 8 hours ago
JSON representation

Repository metadata

A Python package for efficiently aligning organismal taxonomic hierarchies using the Global Names Verifier

README.md

DOI

PyPI - Version
PyPI - Python Version

TaxonoPy: Reproducible, Traceable, and Scalable Biological Taxonomy Alignment

TaxonoPy (taxon-o-pie) is a command-line tool for harmonizing large biodiversity datasets into a consistent taxonomy ready for AI applications. Built on the Global Names Verifier (GNVerifier), it provides complete provenance tracking, flexible resolution strategies, and batch processing of 100M+ records to address challenges in reproducibility and scale in massive multi-source taxonomy alignment.

Documentaion

See https://imageomics.github.io/TaxonoPy for documentation on installation, usage, and more.

Development

See the Wiki Development Page for development instructions.

Citation (CITATION.cff)

abstract: "A Python package for efficiently aligning organismal taxonomic hierarchies using the Global Names Verifier."
authors:
- family-names: "Thompson"
  given-names: "Matthew J."
  orcid: "https://orcid.org/0000-0003-0583-8585"
- family-names: "Campolongo"
  given-names: "Elizabeth G."
  orcid: "https://orcid.org/0000-0003-0846-2413"
- family-names: "Lapp"
  given-names: "Hilmar"
  orcid: "https://orcid.org/0000-0001-9107-0714"
- family-names: "Gu"
  given-names: "Jianyang"
  orcid: "https://orcid.org/0000-0002-4060-7427"
cff-version: 1.2.0
date-released: "2026-02-13"
identifiers:
  - description: "The GitHub release URL of tag v0.2.0."
    type: url
    value: "https://github.com/Imageomics/TaxonoPy/releases/tag/v0.2.0"
  - description: "The GitHub URL of the commit tagged with v0.2.0"
    type: url
    value: "https://github.com/Imageomics/TaxonoPy/tree/<update-after-release>"
keywords:
  - imageomics
  - taxonomy
  - "taxonomic resolution"
  - "tree of life"
  - alignment
  - hierarchy
references:
  - type: software
    title: "GNverifier -- a reconciler and resolver of scientific names against more than 100 data sources."
    version: "v1.2.5"
    authors:
      - family-names: "Mozzherin"
        given-names: "Dmitry"
        orcid: "https://orcid.org/0000-0003-1593-1417"
    repository-code: "https://github.com/gnames/gnverifier"
    date-released: "2025-04-02"
    doi: 10.5281/zenodo.5111542
    license: MIT
license: MIT
message: "If you use this software, please cite it using the metadata from this file."
repository-code: "https://github.com/Imageomics/TaxonoPy"
title: "TaxonoPy"
version: "0.2.0"
doi: "10.5281/zenodo.15499454"
type: software

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 29
Total Committers: 3
Avg Commits per committer: 9.667
Development Distribution Score (DDS): 0.069

Commits in past year: 8
Committers in past year: 2
Avg Commits per committer in past year: 4.0
Development Distribution Score (DDS) in past year: 0.125

Name Email Commits
Matthew Thompson t****9@o****u 27
Elizabeth Campolongo 3****9 1
Dahlializi 1****i 1

Committer domains:


Issue and Pull Request metadata

Last synced: 30 days ago

Total issues: 14
Total pull requests: 15
Average time to close issues: 28 days
Average time to close pull requests: 28 days
Total issue authors: 2
Total pull request authors: 5
Average comments per issue: 0.57
Average comments per pull request: 1.47
Merged pull request: 10
Bot issues: 0
Bot pull requests: 0

Past year issues: 12
Past year pull requests: 7
Past year average time to close issues: 28 days
Past year average time to close pull requests: 21 days
Past year issue authors: 2
Past year pull request authors: 3
Past year average comments per issue: 0.58
Past year average comments per pull request: 1.86
Past year merged pull request: 3
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/imageomics/taxonopy

Top Issue Authors

  • thompsonmj (13)
  • Dahlializi (1)

Top Pull Request Authors

  • thompsonmj (11)
  • Copilot (1)
  • Dahlializi (1)
  • egrace479 (1)
  • vimar-gu (1)

Top Issue Labels

  • enhancement (4)
  • bug (3)
  • documentation (2)
  • edge case (2)

Top Pull Request Labels

  • documentation (1)

Package metadata

pypi.org: taxonopy

A Python package for resolving taxonomic hierarchies using the Global Names Verifier API.

  • Homepage:
  • Documentation: https://github.com/Imageomics/TaxonoPy
  • Licenses: MIT License
  • Latest release: 0.2.0 (published 4 months ago)
  • Last Synced: 2026-06-19T21:01:30.002Z (3 days ago)
  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 75 Last month
  • Rankings:
    • Dependent packages count: 9.096%
    • Average: 30.172%
    • Dependent repos count: 51.248%

Dependencies

.github/workflows/run-tests.yaml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
.github/workflows/validate-zenodo.yaml actions
  • actions/checkout v4 composite
  • actions/setup-node v4 composite
.github/workflows/deploy-docs.yaml actions
  • actions/checkout v4 composite
  • actions/download-artifact v4 composite
  • actions/setup-python v5 composite
  • actions/upload-artifact v4 composite
  • peaceiris/actions-gh-pages v4 composite
.github/workflows/publish-to-pypi.yaml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • pypa/gh-action-pypi-publish release/v1 composite
pyproject.toml pypi
  • pandas *
  • polars *
  • pyarrow *
  • pydantic *
  • requests *
  • tqdm *

Score: 8.9126079636709