• Documents: https://bioinf.shenwei.me/taxonkit (Usage&Examples, Tutorial, 中文介绍)
• Source code: https://github.com/shenwei356/taxonkit
• Latest version:
• Taxid-Changelog: tracking all changes of TaxIds, including deletion, new adding, merge, reuse, and rank/name changes.
• Please cite: https://doi.org/10.1016/j.jgg.2021.03.006
• pytaxonkit, Python bindings for TaxonKit.

• Features
• Subcommands
• Benchmark
• Dataset
• Installation
• Command-line completion
• Citation
• Contact
• License

• Easy to install (download)
  • Statically linked executable binaries for multiple platforms (Linux/Windows/macOS, amd64/arm64)
  • Light weight and out-of-the-box, no dependencies, no compilation, no configuration
  • No database building, just download NCBI taxonomy data and uncompress to $HOME/.taxonkit
• Easy to use (usages and examples)
  • Supporting bash-completion
  • Fast (see benchmark), multiple-CPUs supported, most operations cost 2-10s.
  • Detailed usages and examples
  • Supporting STDIN and (gzipped) input/output file, easily integrated in pipe
• Versatile commands
  • Usage and examples
  • Featured command: tracking monthly changelog of all TaxIds
  • Featured command: reformating lineage into format of seven-level ("superkingdom, phylum, class, order, family, genus, species"
  • Featured command: filtering taxiDs by a rank range, e.g., at or below genus rank.

1. Getting complete lineage for given TaxIds

   

1. Download and uncompress taxdump.tar.gz: ftp://ftp.ncbi.nih.gov/pub/taxonomy/taxdump.tar.gz
2. Copy names.dmp, nodes.dmp, delnodes.dmp and merged.dmp to data directory: $HOME/.taxonkit, e.g., /home/shenwei/.taxonkit ,
3. Optionally copy to some other directories, and later you can refer to using flag --data-dir, or environment variable TAXONKIT_DB.

All-in-one command:

wget -c ftp://ftp.ncbi.nih.gov/pub/taxonomy/taxdump.tar.gz 
tar -zxvf taxdump.tar.gz

mkdir -p $HOME/.taxonkit
cp names.dmp nodes.dmp delnodes.dmp merged.dmp $HOME/.taxonkit

Update dataset: Simply re-download the taxdump files, uncompress and override old ones.

Go to Download Page for more download options and changelogs.

TaxonKit is implemented in Go programming language, executable binary files for most popular operating systems are freely available in release page.

Just download compressed executable file of your operating system, and uncompress it with tar -zxvf *.tar.gz command or other tools. And then:

1. For Linux-like systems

   1. If you have root privilege simply copy it to /usr/local/bin:

       sudo cp taxonkit /usr/local/bin/
      

   2. Or copy to anywhere in the environment variable PATH:

       mkdir -p $HOME/bin/; cp taxonkit $HOME/bin/
      

2. For Windows, just copy taxonkit.exe to C:\WINDOWS\system32.

conda install -c bioconda taxonkit

brew install brewsci/bio/taxonkit

go get -u github.com/shenwei356/taxonkit/taxonkit

Supported shell: bash|zsh|fish|powershell

Bash:

# generate completion shell
taxonkit genautocomplete --shell bash

# configure if never did.
# install bash-completion if the "complete" command is not found.
echo "for bcfile in ~/.bash_completion.d/* ; do source \$bcfile; done" >> ~/.bash_completion
echo "source ~/.bash_completion" >> ~/.bashrc

Zsh:

# generate completion shell
taxonkit genautocomplete --shell zsh --file ~/.zfunc/_taxonkit

# configure if never did
echo 'fpath=( ~/.zfunc "${fpath[@]}" )' >> ~/.zshrc
echo "autoload -U compinit; compinit" >> ~/.zshrc

fish:

taxonkit genautocomplete --shell fish --file ~/.config/fish/completions/taxonkit.fish

If you use TaxonKit in your work, please cite:

Shen, W., Ren, H., TaxonKit: a practical and efficient NCBI Taxonomy toolkit, Journal of Genetics and Genomics, https://doi.org/10.1016/j.jgg.2021.03.006

Create an issue to report bugs, propose new functions or ask for help.

MIT License