{"id":32135294,"url":"https://github.com/torognes/vsearch","last_synced_at":"2026-04-02T15:14:29.834Z","repository":{"id":17083265,"uuid":"19848353","full_name":"torognes/vsearch","owner":"torognes","description":"Versatile open-source tool for microbiome analysis","archived":false,"fork":false,"pushed_at":"2026-03-27T11:52:29.000Z","size":8221,"stargazers_count":742,"open_issues_count":40,"forks_count":132,"subscribers_count":39,"default_branch":"master","last_synced_at":"2026-03-27T22:55:22.788Z","etag":null,"topics":["amplicon","bioinformatics","chimera","clustering","fasta","fastq","metabarcoding","metagenomics","microbiome","search","sequence-alignment"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/torognes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-05-16T07:36:59.000Z","updated_at":"2026-03-27T10:19:18.000Z","dependencies_parsed_at":"2023-10-03T18:23:55.146Z","dependency_job_id":"a3fda692-e8da-4e0c-bbd3-0000dddfde76","html_url":"https://github.com/torognes/vsearch","commit_stats":{"total_commits":966,"total_committers":16,"mean_commits":60.375,"dds":0.3830227743271222,"last_synced_commit":"847e9a89533e14bd6a66bf27c4b18e92022cca37"},"previous_names":[],"tags_count":140,"template":false,"template_full_name":null,"purl":"pkg:github/torognes/vsearch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torognes%2Fvsearch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torognes%2Fvsearch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torognes%2Fvsearch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torognes%2Fvsearch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/torognes","download_url":"https://codeload.github.com/torognes/vsearch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torognes%2Fvsearch/sbom","scorecard":{"id":480367,"data":{"date":"2025-08-11","repo":{"name":"github.com/torognes/vsearch","commit":"258010e61a091842577f28438282f329e32a4cab"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.6,"checks":[{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: topLevel 'contents' permission set to 'write': .github/workflows/jekyll-gh-pages.yml:14","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":6,"reason":"1 commit(s) and 7 issue activity found in the last 90 days -- score normalized to 6","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE.txt:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v2.30.0 not signed: https://api.github.com/repos/torognes/vsearch/releases/202858416","Warn: release artifact v2.29.4 not signed: https://api.github.com/repos/torognes/vsearch/releases/200406483","Warn: release artifact v2.29.3 not signed: https://api.github.com/repos/torognes/vsearch/releases/198086900","Warn: release artifact v2.29.2 not signed: https://api.github.com/repos/torognes/vsearch/releases/191837304","Warn: release artifact v2.29.1 not signed: https://api.github.com/repos/torognes/vsearch/releases/181761541","Warn: release artifact v2.30.0 does not have provenance: https://api.github.com/repos/torognes/vsearch/releases/202858416","Warn: release artifact v2.29.4 does not have provenance: https://api.github.com/repos/torognes/vsearch/releases/200406483","Warn: release artifact v2.29.3 does not have provenance: https://api.github.com/repos/torognes/vsearch/releases/198086900","Warn: release artifact v2.29.2 does not have provenance: https://api.github.com/repos/torognes/vsearch/releases/191837304","Warn: release artifact v2.29.1 does not have provenance: https://api.github.com/repos/torognes/vsearch/releases/181761541"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/jekyll-gh-pages.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/torognes/vsearch/jekyll-gh-pages.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/jekyll-gh-pages.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/torognes/vsearch/jekyll-gh-pages.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/jekyll-gh-pages.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/torognes/vsearch/jekyll-gh-pages.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/jekyll-gh-pages.yml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/torognes/vsearch/jekyll-gh-pages.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/jekyll-gh-pages.yml:60: update your workflow using https://app.stepsecurity.io/secureworkflow/torognes/vsearch/jekyll-gh-pages.yml/master?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating alpine:latest to alpine:latest@sha256:4bcff63911fcb4448bd4fdacec207030997caf25e9bea4045fa6c8c44de311d1","Warn: containerImage not pinned by hash: dockerfiles/Dockerfile.debian:1: pin your Docker image by updating debian:latest to debian:latest@sha256:6d87375016340817ac2391e670971725a9981cfc24e221c47734681ed0f6c0f5","Warn: containerImage not pinned by hash: dockerfiles/Dockerfile.fedora:1: pin your Docker image by updating fedora:latest to fedora:latest@sha256:3da64cb89971a1cdbc6046e307eeebcb54f7281c0a606ee48d9995473f6b88d5","Info:   0 out of   5 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}}]},"last_synced_at":"2025-08-19T16:26:57.012Z","repository_id":17083265,"created_at":"2025-08-19T16:26:57.012Z","updated_at":"2025-08-19T16:26:57.012Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31097216,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-28T11:37:01.486Z","status":"ssl_error","status_checked_at":"2026-03-28T11:36:50.178Z","response_time":79,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amplicon","bioinformatics","chimera","clustering","fasta","fastq","metabarcoding","metagenomics","microbiome","search","sequence-alignment"],"created_at":"2025-10-21T03:58:05.034Z","updated_at":"2026-04-02T15:14:29.822Z","avatar_url":"https://github.com/torognes.png","language":"C++","funding_links":[],"categories":["Specific workflow"],"sub_categories":["Community analysis"],"readme":"[![Build and test](https://github.com/torognes/vsearch/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/torognes/vsearch/actions/workflows/build-and-test.yml)\n\n# VSEARCH\n\n## Introduction\n\nThe aim of this project is to create an alternative to the [USEARCH](https://www.drive5.com/usearch/) tool developed by Robert C. Edgar (2010). The new tool should:\n\n* have open source code with an appropriate open source license\n* be free of charge, gratis\n* have a 64-bit design that handles very large databases and much more than 4GB of memory\n* be as accurate or more accurate than usearch\n* be as fast or faster than usearch\n\nWe have implemented a tool called VSEARCH which supports *de novo* and reference based chimera detection, clustering, full-length and prefix dereplication, rereplication, reverse complementation, masking, all-vs-all pairwise global alignment, exact and global alignment searching, shuffling, subsampling and sorting. It also supports FASTQ file analysis, filtering, conversion and merging of paired-end reads.\n\nVSEARCH stands for vectorized search, as the tool takes advantage of parallelism in the form of SIMD vectorization as well as multiple threads to perform accurate alignments at high speed. VSEARCH uses an optimal global aligner (full dynamic programming Needleman-Wunsch), in contrast to USEARCH which by default uses a heuristic seed and extend aligner. This usually results in more accurate alignments and overall improved sensitivity (recall) with VSEARCH, especially for alignments with gaps.\n\n[VSEARCH binaries](https://github.com/torognes/vsearch/releases/latest) are provided for GNU/Linux on five 64-bit processor architectures: x86_64, POWER8 (ppc64le), ARMv8 (aarch64), little-endian 64-bit RISC-V (riscv64), and little-endian 64-bit MIPS (mips64el). Binaries are also provided for macOS (version 10.9 Mavericks or later) on Intel (x86_64) and Apple Silicon (ARMv8), as well as Windows (64-bit, version 7 or higher, on x86_64). VSEARCH contains native SIMD code for three processor architectures (SSE2/SSSE3, AltiVec/VMX/VSX, Neon). In addition, VSEARCH uses the SIMD Everywhere (SIMDe) library to enable building on riscv64, mips64el, and other little-endian architectures, but the performance may be lower than a native implementation.\n\n| CPU \\ OS      | GNU/Linux     | macOS  | Windows   |\n| ------------- | :-----------: | :----: | :-------: |\n| x86_64        |  ✔            |  ✔     |  ✔        |\n| ARMv8         |  ✔            |  ✔     |           |\n| POWER8        |  ✔            |        |           |\n| RISC-V 64 LE  |  ✔            |        |           |\n| MIPS 64 LE    |  not tested   |        |           |\n\nVarious packages, plugins and wrappers for VSEARCH are also available from other sources - see [below](https://github.com/torognes/vsearch#packages-plugins-and-wrappers).\n\nThe source code compiles correctly with `gcc` (versions 4.8.5 to 14.0)\nand `llvm-clang` (3.8 to 19.0). The source code should also compile on\n[FreeBSD](https://www.freebsd.org/) and\n[NetBSD](https://www.netbsd.org/) systems.\n\nVSEARCH can directly read input query and database files that are compressed using gzip (.gz) and bzip2 (.bz2) if the zlib and bzip2 libraries are available.\n\nMost of the nucleotide based commands and options in USEARCH version 7 are supported, as well as some in version 8. The same option names as in USEARCH version 7 has been used in order to make VSEARCH an almost drop-in replacement. VSEARCH does not support amino acid sequences or local alignments. These features may be added in the future.\n\n## Getting Help\n\nIf you can't find an answer in [online documentation](https://torognes.github.io/vsearch/), or in the [manpage](https://github.com/torognes/vsearch/releases/download/v2.30.6/vsearch_manual.pdf), please visit the [VSEARCH Web Forum](https://groups.google.com/forum/#!forum/vsearch-forum) to post a question or start a discussion.\n\n## Example\n\nIn the example below, VSEARCH will identify sequences in the file database.fsa that are at least 90% identical on the plus strand to the query sequences in the file queries.fsa and write the results to the file alnout.txt.\n\n`./vsearch --usearch_global queries.fsa --db database.fsa --id 0.9 --alnout alnout.txt`\n\n## Download and install\n\n**Source distribution** To download the source distribution from a [release](https://github.com/torognes/vsearch/releases) and build the executable and the documentation, use the following commands:\n\n```\nwget https://github.com/torognes/vsearch/archive/v2.30.6.tar.gz\ntar xzf v2.30.6.tar.gz\ncd vsearch-2.30.6\n./autogen.sh\n./configure CFLAGS=\"-O2\" CXXFLAGS=\"-O2\"\nmake ARFLAGS=\"cr\"\nsudo make install\n```\n\nYou may customize the installation directory using the `--prefix=DIR` option to `configure`. If the compression libraries [zlib](https://www.zlib.net) and/or [bzip2](https://www.sourceware.org/bzip2/) are installed on the system, they will be detected automatically and support for compressed files will be included in vsearch (see section **Dependencies** below). Support for compressed files may be disabled using the `--disable-zlib` and `--disable-bzip2` options to `configure`. A PDF version of the manual will be created from the `vsearch.1` manual file if `ps2pdf` is available, unless disabled using the `--disable-pdfman` option to `configure`. It is recommended to run configure with the options `CFLAGS=\"-O2\"` and `CXXFLAGS=\"-O2\"`. Other  options may also be applied to `configure`, please run `configure -h` to see them all. GNU autoconf (version 2.63 or later), automake and the GCC C++ (`g++`) compiler is required to build vsearch. Version 3.82 or later of `make` may be required on Linux, while version 3.81 is sufficient on macOS.\n\nWarning: Compiling the `align_simd.cc` file on x86_64 systems using the GNU C++ compiler version 9 or later with the `-O3` optimization option on may result in incorrect code that may cause bad alignments in some circumstances. This was due to the `-ftree-partial-pre` optimization enabled by `-O3`. A compiler pragma has been inserted in the code to specifically turn off this optimization for the affected code. Using `-O3` should be safe.\n\nTo build VSEARCH on Debian and similar Linux distributions (Ubuntu etc) you'll need the following packages: autoconf, automake, g++, ghostscript, groff, libbz2-dev, make, zlib1g-dev. Include libsimde-dev to build on riscv64 or mips64el.\n\nTo build VSEARCH on Fedora and similar Linux distributions (RHEL, Centos etc) you'll need the following packages: autoconf, automake, bzip2-devel, gcc-c++, ghostscript, groff-base, make, zlib-devel.\n\nInstead of downloading the source distribution as a compressed archive, you could clone the repo and build it as shown below. The options to `configure` as described above are still valid.\n\n```\ngit clone https://github.com/torognes/vsearch.git\ncd vsearch\n./autogen.sh\n./configure CFLAGS=\"-O2\" CXXFLAGS=\"-O2\"\nmake ARFLAGS=\"cr\"\nsudo make install\n```\n\n**Binary distribution**: Starting with version 1.4.0, binary distribution files containing pre-compiled binaries as well as the documentation will be made available as part of each [release](https://github.com/torognes/vsearch/releases). The included executables include support for input files compressed by zlib and bzip2 (with files usually ending in `.gz` or `.bz2`).\n\nBinary distributions are provided for x86-64 systems running GNU/Linux, macOS (version 10.7 or higher) or Windows (64-bit, version 7 or higher), 64-bit AMDv8 (aarch64) systems running GNU/Linux or macOS, as well as POWER8 (ppc64le), 64-bit little-endian RISC-V (risv64), and 64-bit little endian MIPS (mips64el) systems running GNU/Linux. A universal macOS binary is also provided. In addition, an x86_64 binary built for the discontinued RHEL 7 and CentOS 7 linux distributions is provided. The other Linux binaries are built on Debian 11 (oldstable, Bullseye). Static binaries are available for all Linux architectures except x86_64, these can be used on systems that do not have all the necessary libraries installed. The Windows binary was built with cross compilation using [Mingw-w64](http://mingw-w64.org/).\n\nDownload the appropriate executable for your system using the following commands if you are using a Linux or macOS system:\n\n```sh\nwget https://github.com/torognes/vsearch/releases/download/v{VERSION}/vsearch-{VERSION}-{OS}-{ARCH}.tar.gz\ntar xzf vsearch-{VERSION}-{OS}-{ARCH}.tar.gz\n```\n\nReplace `{VERSION}` with the VSEARCH version number (e.g. `2.30.6`), `{OS}` with the target operating system (`linux` or `macos`), and `{ARCH}` with the architecture (`x86_64`, `aarch64`, `ppc64le`, `riscv64`, or `mips64el`). You could add `-static` after `{ARCH}` to get a statically compiled version for Linux (except x86_64). The name of the binary for the RHEL 7 and CentOS 7 Linux distributions ends in `-ubi7`.\n\nOr, if you are using Windows, download and extract (unzip) the contents of this file:\n\n```\nhttps://github.com/torognes/vsearch/releases/download/v{VERSION}/vsearch-{VERSION}-win-x86_64.zip\n```\n\n**Linux and Mac**: You will now have the binary distribution in a folder called `vsearch-{VERSION}-{OS}-{ARCH}` in which you will find three subfolders `bin`, `man` and `doc`. We recommend making a copy or a symbolic link to the vsearch binary `bin/vsearch` in a folder included in your `$PATH`, and a copy or a symbolic link to the vsearch man page `man/vsearch.1` in a folder included in your `$MANPATH`. The PDF version of the manual is available in `doc/vsearch_manual.pdf`.\n\n**Windows**: You will now have the binary distribution in a folder\ncalled `vsearch-{VERSION}-win-x86_64`. The vsearch executable is called\n`vsearch.exe`. The manual in PDF format is called\n`vsearch_manual.pdf`. If you want to be able to call `vsearch.exe`\nfrom any command prompt window, you can put the VSEARCH executable in\na folder (for instance `C:\\Users\\\u003cyourname\u003e\\bin`), and add the new\nfolder to the user `Path`: open the `Environment Variables` window by\nsearching for it in the Start menu, `Edit` user variables, add\n`;C:\\Users\\\u003cyourname\u003e\\bin` to the end of the `Path` variable, and save\nyour changes. The windows distribution also includes the `libbz2.dll`\nand `zlib1.dll` files required for reading compressed input\nfiles. These DLL's have been obtained for mingw-w64 from the MSYS2\nplatform.\n\n**Documentation:** The VSEARCH user's manual is available in the `man` folder in the form of a [man page](https://github.com/torognes/vsearch/blob/master/man/vsearch.1). A pdf version ([vsearch_manual.pdf](https://github.com/torognes/vsearch/releases/download/v2.30.6/vsearch_manual.pdf)) will be generated by `make`. To install the manpage manually, copy the `vsearch.1` file or a create a symbolic link to `vsearch.1` in a folder included in your `$MANPATH`. The manual in both formats is also available with the binary distribution. The manual in PDF form ([vsearch_manual.pdf](https://github.com/torognes/vsearch/releases/download/v2.30.6/vsearch_manual.pdf)) is also attached to the latest [release](https://github.com/torognes/vsearch/releases).\n\n\n## Packages, plugins, and wrappers\n\n**Conda package** Thanks to the [BioConda](https://bioconda.github.io/) team, there is now a [vsearch package](https://anaconda.org/bioconda/vsearch) in [Conda](https://conda.io/).\n\n**Debian package** Thanks to the [Debian Med](https://www.debian.org/devel/debian-med/) team, there is now a [vsearch](https://packages.debian.org/sid/vsearch) package in [Debian](https://www.debian.org/).\n\n**FreeBSD ports package** Thanks to [Jason Bacon](https://github.com/outpaddling), a [vsearch](https://www.freebsd.org/cgi/ports.cgi?query=vsearch\u0026stype=all) [FreeBSD ports](https://www.freebsd.org/ports/) package is available. Install the binary package with `pkg install vsearch`, or build from source with additional optimizations.\n\n**Galaxy wrapper** Thanks to the work of the [Intergalactic Utilities Commission](https://wiki.galaxyproject.org/IUC) members, VSEARCH is now part of the [Galaxy ToolShed](https://toolshed.g2.bx.psu.edu/view/iuc/vsearch/).\n\n**Homebrew package** Thanks to [Torsten Seeman](https://github.com/tseemann), a [vsearch package](https://formulae.brew.sh/formula/vsearch) for [Homebrew](http://brew.sh/) has been made.\n\n**Pkgsrc package** Thanks to [Jason Bacon](https://github.com/outpaddling), a vsearch [pkgsrc](https://www.pkgsrc.org) package is available for NetBSD and other UNIX-like systems. Install the binary package with `pkgin install vsearch`, or build from source with additional optimizations.\n\n**QIIME 2 plugin** Thanks to the [QIIME 2](https://github.com/qiime2) team, there is now a plugin called [q2-vsearch](https://github.com/qiime2/q2-vsearch) for [QIIME 2](https://qiime2.org).\n\n\n## Converting output to a biom file for use in QIIME and other software\n\nWith the `from-uc`command in [biom](http://biom-format.org/) 2.1.5 or later, it is possible to convert data in a `.uc` file produced by vsearch into a biom file that can be read by QIIME and other software. It is described [here](https://gist.github.com/gregcaporaso/f3c042e5eb806349fa18).\n\nPlease note that VSEARCH version 2.2.0 and later are able to directly output OTU tables in biom 1.0 format as well as the classic and mothur formats.\n\n\n## Implementation details and initial assessment\n\nPlease see the paper for details:\n\nRognes T, Flouri T, Nichols B, Quince C, Mahé F. (2016) VSEARCH: a versatile open source tool for metagenomics. PeerJ 4:e2584\ndoi: [10.7717/peerj.2584](https://doi.org/10.7717/peerj.2584)\n\n\n## Dependencies\n\nCompiling VSEARCH requires either GCC (`g++`) or `clang`, `make` and the autotools (`ui-auto` on Debian-based distributions). Optionally, the header files for the following two optional libraries are required if support for gzip and bzip2 compressed FASTA and FASTQ input files is needed:\n\n* libz (zlib library) (`zlib.h` header file, available as `zlib1g-dev` on Debian-based distributions) (optional)\n* libbz2 (bzip2lib library) (`bzlib.h` header file, available as `libbz2-dev`on Debian-based distributions) (optional)\n\nVSEARCH will automatically check whether these libraries are available and load them dynamically.\n\nOn Windows these libraries are called `zlib1.dll` and `libbz2.dll`. These DLL's are included with the released distribution of vsearch 2.27.0 and later.\n\nTo create the PDF file with the manual the ps2pdf tool is required. It is part of the `ghostscript` package.\n\n\n## VSEARCH license and third party licenses\n\nThe VSEARCH code is dual-licensed either under the GNU General Public License version 3 or under the BSD 2-clause license. Please see LICENSE.txt for details.\n\nVSEARCH includes code from several other projects. We thank the authors for making their source code available.\n\nVSEARCH includes code from Google's [CityHash project](https://github.com/google/cityhash) by Geoff Pike and Jyrki Alakuijala, providing some excellent hash functions available under a MIT license.\n\nVSEARCH includes code derived from Tatusov and Lipman's DUST program that is in the public domain.\n\nVSEARCH includes public domain code written by Alexander Peslyak for the MD5 message digest algorithm.\n\nVSEARCH includes public domain code written by Steve Reid and others for the SHA1 message digest algorithm.\n\nThe VSEARCH distribution includes code from GNU Autoconf which normally is available under the GNU General Public License, but may be distributed with the special autoconf configure script exception.\n\nVSEARCH may include code from the [zlib](https://www.zlib.net) library copyright Jean-loup Gailly and Mark Adler, distributed under the [zlib license](https://www.zlib.net/zlib_license.html).\n\nVSEARCH may include code from the [bzip2](https://www.sourceware.org/bzip2/) library copyright Julian R. Seward, distributed under a BSD-style license.\n\n\n## Code\n\nThe code is written mostly in C++.\n\nFile | Description\n---|---\n**align_simd.cc** | SIMD parallel global alignment of 1 query with 8 database sequences\n**allpairs.cc** | All-vs-all optimal global pairwise alignment (no heuristics)\n**arch.cc** | Architecture specific code (Mac/Linux)\n**attributes.cc** | Extraction and printing of attributes in FASTA headers\n**bitmap.cc** | Implementation of bitmaps\n**chimera.cc** | Chimera detection\n**city.cc** | CityHash code\n**cluster.cc** | Clustering (cluster\\_fast and cluster\\_smallmem)\n**cpu.cc** | Code dependent on specific cpu features (e.g. ssse3)\n**cut.cc** | Restriction site cutting\n**db.cc** | Handles the database file read, access etc\n**dbhash.cc** | Database hashing for exact searches\n**dbindex.cc** | Indexes the database by identifying unique kmers in the sequences\n**derep.cc** | Dereplication, full-length\n**derep_prefix.cc** | Dereplication, prefix\n**derep_smallmem.cc** | Dereplication, small memory usage\n**dynlibs.cc** | Dynamic loading of compression libraries\n**eestats.cc** | Produce statistics for fastq_eestats command\n**fasta.cc** | FASTA file parser\n**fasta2fastq.cc** | FASTA to FASTQ conversion\n**fastq.cc** | FASTQ file parser\n**fastq_chars.cc** | FASTQ statistics\n**fastq_join.cc** | FASTQ paired-end reads joining\n**fastqops.cc** | FASTQ file statistics etc\n**fastx.cc** | Detection of FASTA and FASTQ files, wrapper for FASTA and FASTQ parsers\n**filter.cc** | Trimming and filtering of sequences in FASTA and FASTQ files\n**getseq.cc** | Extraction of sequences based on header labels\n**kmerhash.cc** | Hash for kmers used by paired-end read merger\n**linmemalign.cc** | Linear memory global sequence aligner\n**mask.cc** | Masking (DUST)\n**md5.c** | MD5 message digest\n**mergepairs.cc** | Paired-end read merging\n**minheap.cc** | A minheap implementation for the list of top kmer matches\n**msa.cc** | Simple multiple sequence alignment and consensus sequence computation for clusters\n**orient.cc** | Orient direction of sequences based on reference database\n**otutable.cc** | Generate OTU tables in various formats\n**rereplicate.cc** | Rereplication\n**results.cc** | Output results in various formats (alnout, userout, blast6, uc)\n**search.cc** | Implements search using global alignment\n**search_exact.cc** | Exact search functions\n**searchcore.cc** | Core search functions for searching, clustering and chimera detection\n**sff_convert.cc** | SFF to FASTQ file conversion\n**sha1.c** | SHA1 message digest\n**showalign.cc** | Output an alignment in a human-readable way given a CIGAR-string and the sequences\n**shuffle.cc** | Shuffle sequences\n**sintax.cc** | Taxonomic classification using Sintax method\n**sortbylength.cc** | Code for sorting by length\n**sortbysize.cc** | Code for sorting by size (abundance)\n**subsample.cc** | Subsampling reads from a FASTA file\n**tax.cc** | Taxonomy information parsing\n**udb.cc** | UDB database file handling\n**unique.cc** | Find unique kmers in a sequence\n**userfields.cc** | Code for parsing the userfields option argument\n**util.cc** | Various common utility functions\n**vsearch.cc** | Main program file, general initialization, reads arguments and parses options, writes info.\n**utils/maps.cc** | Utilities, maps for encoding of nucleotides\n**utils/seqcmp.cpp** | Utilities, sequence comparison\n\nVSEARCH may be compiled with zlib or bzip2 integration that allows it to read compressed FASTA files. The [zlib](http://www.zlib.net/) and the [bzip2](https://www.sourceware.org/bzip2/) libraries are needed for this.\n\n\n## Bugs\n\nAll bug reports are highly appreciated.\nYou may submit a bug report here on GitHub as an [issue](https://github.com/torognes/vsearch/issues) (preferred),\nyou could post a message on the [VSEARCH Web Forum](https://groups.google.com/forum/#!forum/vsearch-forum)\nor you could send an email to [torognes@ifi.uio.no](mailto:torognes@ifi.uio.no?subject=bug_in_vsearch).\n\n\n## Limitations\n\nVSEARCH is designed for rather short sequences, and will be slow when sequences are longer than about 5,000 bp. This is because it always performs optimal global alignment on selected sequences.\n\n\n## The VSEARCH team\n\nThe main contributors to VSEARCH:\n\n* Torbj\u0026oslash;rn Rognes \u003ctorognes@ifi.uio.no\u003e (Coding, testing, documentation, evaluation)\n* Fr\u0026eacute;d\u0026eacute;ric Mah\u0026eacute; \u003cmahe@rhrk.uni-kl.de\u003e (Documentation, testing, coding, feature suggestions)\n* Tom\u0026aacute;\u0026scaron; Flouri \u003ctomas.flouri@h-its.org\u003e (Coding, testing)\n* Christopher Quince \u003cc.quince@warwick.ac.uk\u003e (Initiator, feature suggestions, evaluation)\n* Ben Nichols \u003cb.nichols.1@research.gla.ac.uk\u003e (Evaluation)\n\n\n## Acknowledgements\n\nSpecial thanks to the following people for patches, suggestions, computer access etc:\n\n* Davide Albanese\n* Colin Brislawn\n* Michael R. Crusoe\n* Jeff Epler\n* Christopher M. Sullivan\n* Andreas Tille\n* Sarah Westcott\n\n\n## Citing VSEARCH\n\nPlease cite the following publication if you use VSEARCH:\n\nRognes T, Flouri T, Nichols B, Quince C, Mahé F. (2016) VSEARCH: a versatile open source tool for metagenomics. PeerJ 4:e2584.\ndoi: [10.7717/peerj.2584](https://doi.org/10.7717/peerj.2584)\n\nPlease note that citing any of the underlying algorithms, e.g. UCHIME, may also be appropriate.\n\n\n## Test datasets\n\nTest datasets (found in the separate vsearch-data repository) were\nobtained from\nthe BioMarks project ([Logares et al. 2014](https://doi.org/10.1016/j.cub.2014.02.050)),\nthe [TARA OCEANS project](https://oceans.taraexpeditions.org/en/) ([Karsenti et al. 2011](https://doi.org/10.1371/journal.pbio.1001177))\nand the [Protist Ribosomal Reference Database (PR\u003csup\u003e2\u003c/sup\u003e)](https://github.com/pr2database/pr2database) ([Guillou et al. 2013](https://doi.org/10.1093/nar/gks1160)).\n\n\n## References\n\n* Edgar RC (2010)\n**Search and clustering orders of magnitude faster than BLAST.**\n*Bioinformatics*, 26 (19): 2460-2461.\ndoi:[10.1093/bioinformatics/btq461](https://doi.org/10.1093/bioinformatics/btq461)\n\n* Edgar RC (2016)\n**SINTAX: a simple non-Bayesian taxonomy classifier for 16S and ITS sequences.**\n*bioRxiv*.\ndoi:[10.1101/074161](https://doi.org/10.1101/074161)\n\n* Edgar RC (2016)\n**UNOISE2: improved error-correction for Illumina 16S and ITS amplicon sequencing.**\n*bioRxiv*.\ndoi:[10.1101/081257](https://doi.org/10.1101/081257)\n\n* Edgar RC, Flyvbjerg H (2015)\n**Error filtering, pair assembly and error correction for next-generation sequencing reads.**\n*Bioinformatics*, 31 (21): 3476-3482.\ndoi:[10.1093/bioinformatics/btv401](https://doi.org/10.1093/bioinformatics/btv401)\n\n* Edgar RC, Haas BJ, Clemente JC, Quince C, Knight R (2011)\n**UCHIME improves sensitivity and speed of chimera detection.**\n*Bioinformatics*, 27 (16): 2194-2200.\ndoi:[10.1093/bioinformatics/btr381](https://doi.org/10.1093/bioinformatics/btr381)\n\n* Guillou L, Bachar D, Audic S, Bass D, Berney C, Bittner L, Boutte C, Burgaud G, de Vargas C, Decelle J, del Campo J, Dolan J, Dunthorn M, Edvardsen B, Holzmann M, Kooistra W, Lara E, Lebescot N, Logares R, Mahé F, Massana R, Montresor M, Morard R, Not F, Pawlowski J, Probert I, Sauvadet A-L, Siano R, Stoeck T, Vaulot D, Zimmermann P \u0026 Christen R (2013)\n**The Protist Ribosomal Reference database (PR2): a catalog of unicellular eukaryote Small Sub-Unit rRNA sequences with curated taxonomy.**\n*Nucleic Acids Research*, 41 (D1), D597-D604.\ndoi:[10.1093/nar/gks1160](https://doi.org/10.1093/nar/gks1160)\n\n* Karsenti E, González Acinas S, Bork P, Bowler C, de Vargas C, Raes J, Sullivan M B, Arendt D, Benzoni F, Claverie J-M, Follows M, Jaillon O, Gorsky G, Hingamp P, Iudicone D, Kandels-Lewis S, Krzic U, Not F, Ogata H, Pesant S, Reynaud E G, Sardet C, Sieracki M E, Speich S, Velayoudon D, Weissenbach J, Wincker P \u0026 the Tara Oceans Consortium (2011)\n**A holistic approach to marine eco-systems biology.**\n*PLoS Biology*, 9(10), e1001177.\ndoi:[10.1371/journal.pbio.1001177](https://doi.org/10.1371/journal.pbio.1001177)\n\n* Logares R, Audic S, Bass D, Bittner L, Boutte C, Christen R, Claverie J-M, Decelle J, Dolan J R, Dunthorn M, Edvardsen B, Gobet A, Kooistra W H C F, Mahé F, Not F, Ogata H, Pawlowski J, Pernice M C, Romac S, Shalchian-Tabrizi K, Simon N, Stoeck T, Santini S, Siano R, Wincker P, Zingone A, Richards T, de Vargas C \u0026 Massana R (2014) **The patterning of rare and abundant community assemblages in coastal marine-planktonic microbial eukaryotes.**\n*Current Biology*, 24(8), 813-821.\ndoi:[10.1016/j.cub.2014.02.050](https://doi.org/10.1016/j.cub.2014.02.050)\n\n* Rognes T (2011)\n**Faster Smith-Waterman database searches by inter-sequence SIMD parallelisation.**\n*BMC Bioinformatics*, 12: 221.\ndoi:[10.1186/1471-2105-12-221](https://doi.org/10.1186/1471-2105-12-221)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorognes%2Fvsearch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftorognes%2Fvsearch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorognes%2Fvsearch/lists"}