{"id":49543272,"url":"https://github.com/zellerlab/flexprofiler","last_synced_at":"2026-05-02T16:31:19.855Z","repository":{"id":339398646,"uuid":"1151529728","full_name":"zellerlab/flexprofiler","owner":"zellerlab","description":"Highly parallelised multi-taxonomic profiling of shotgun and 16S metagenomic data","archived":false,"fork":false,"pushed_at":"2026-03-05T17:36:26.000Z","size":18145,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-05T20:21:16.601Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Nextflow","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zellerlab.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATIONS.md","codeowners":".github/CODEOWNERS","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":"2026-02-06T15:26:40.000Z","updated_at":"2026-02-24T17:04:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zellerlab/flexprofiler","commit_stats":null,"previous_names":["zellerlab/flexprofiler"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/zellerlab/flexprofiler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zellerlab%2Fflexprofiler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zellerlab%2Fflexprofiler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zellerlab%2Fflexprofiler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zellerlab%2Fflexprofiler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zellerlab","download_url":"https://codeload.github.com/zellerlab/flexprofiler/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zellerlab%2Fflexprofiler/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32542005,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"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":[],"created_at":"2026-05-02T16:31:17.807Z","updated_at":"2026-05-02T16:31:19.845Z","avatar_url":"https://github.com/zellerlab.png","language":"Nextflow","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/images/zellerlab-flexprofiler_logo_dark.png\"\u003e\n    \u003cimg alt=\"zellerlab/flexprofiler\" src=\"docs/images/zellerlab-flexprofiler_logo_generic.png\"\u003e\n  \u003c/picture\u003e\n\u003c/h1\u003e\n\n## Introduction\n\n**zellerlab/flexprofiler** is a bioinformatics best-practice analysis pipeline for (microbiome) taxonomic classification and profiling of shotgun and 16S metagenomic data. It allows for in-parallel taxonomic identification of reads or taxonomic abundance estimation with multiple classification and profiling tools against multiple databases, and produces standardised output tables for facilitating results comparison between different tools and databases.\nIt aims to enable microbiome profiling not only of single datasets but also of collections of studies for meta-analisis.\n\n**zellerlab/flexprofiler** is an adaptation of [**nf-core/taxprofiler**](https://github.com/nf-core/taxprofiler) for the needs of the Zeller lab.\nMany features of **nf-core/taxprofiler** that are not needed for the Zeller lab have been removed for simplicity, and support for 16S sequencing data and meta-analyses has been added.\nThis is not strictly a fork of **nf-core/taxprofiler**, as the two pipelines are planned to diverge consistently with their different intended use.\nWe plan to contribute to **nf-core** modules or other components of more general interest, and to implement relevent **nf-core** developments in this pipeline on an irregular schedule.\n\n## Pipeline simplified overview\n\n1. Read QC ([`FastQC`](https://www.bioinformatics.babraham.ac.uk/projects/fastqc/))\n2. Read pre-processing\n   - Adapter clipping and merging: [fastp](https://github.com/OpenGene/fastp)\n   - Host-read removal: [BowTie2](http://bowtie-bio.sourceforge.net/bowtie2/)\n3. Performs taxonomic classification and/or profiling using one or more of:\n   - [mOTUs](https://motus-tool.org/)\n4. Standardises and collates output tables (tool-specific)\n5. Present QC for raw reads ([`MultiQC`](http://multiqc.info/))\n\n## For Zellerlab internal users\nA set of pre-configured options used internally in the group is documented [here](docs/zellerlab.md).\n\n## Usage\n\n\u003e [!NOTE]\n\u003e If you are new to Nextflow and nf-core, please refer to [this page](https://nf-co.re/docs/usage/installation) on how to set-up Nextflow. Make sure to [test your setup](https://nf-co.re/docs/usage/introduction#how-to-run-a-pipeline) with `-profile test` before running the workflow on actual data.\n\nFirst, prepare a samplesheet with your input data that looks as follows:\n\n```csv title=\"samplesheet.csv\"\nsample,run_accession,instrument_platform,fastq_1,fastq_2,fasta\n2612,run1,ILLUMINA,2612_run1_R1.fq.gz,,\n2612,run2,ILLUMINA,2612_run2_R1.fq.gz,,\n2612,run3,ILLUMINA,2612_run3_R1.fq.gz,2612_run3_R2.fq.gz,\n```\n\nEach row represents a fastq file (single-end), a pair of fastq files (paired end), or a fasta (with long reads).\n\nAdditionally, you will need a database sheet that looks as follows:\n\n```csv title=\"databases.csv\"\ntool,db_name,db_params,db_path\nkraken2,db2,--quick,/\u003cpath\u003e/\u003cto\u003e/kraken2/testdb-kraken2.tar.gz\nmetaphlan,db1,,/\u003cpath\u003e/\u003cto\u003e/metaphlan/metaphlan_database/\n```\n\nThat includes directories or `.tar.gz` archives containing databases for the tools you wish to run the pipeline against.\n\nNow, you can run the pipeline using:\n\n```bash\nnextflow run zellerlab/flexprofiler \\\n   -profile \u003cdocker/singularity/.../institute\u003e \\\n   --input samplesheet.csv \\\n   --databases databases.csv \\\n   --outdir \u003cOUTDIR\u003e  \\\n   --run_motus\n```\n\n\u003e [!WARNING]\n\u003e Please provide pipeline parameters via the CLI or Nextflow `-params-file` option. Custom config files including those provided by the `-c` Nextflow option can be used to provide any configuration _**except for parameters**_; see [docs](https://nf-co.re/docs/usage/getting_started/configuration#custom-configuration-files).\n\nFor more details and further functionality, please refer to the [usage documentation](docs/usage.md) and the [parameter documentation](docs/parameters.md).\n\n\n### Database download\n\nTo use **zellerlab/flexprofiler** you need the databases that the profiling tools that you want to run require.\nThese can be downloaded using [this script](utils/fetch_databases.sh), which requires as argument the a path where the databases will be downloaded.\nThe script also generates a `flexprofiler_databases.csv` file in the local directory, which can be used in input for the pipeline.\n\n```bash\nfetch_databases.sh \u003cout_database_path\u003e\n```\n\n\u003e [!IMPORTANT]\n\u003e If you are a member of the Zeller lab, most likely you do not need to download the databases as this has already been done for you in a centralised location.\n\u003e Databases have been already set up for the following compute environments with corresponding profiles:\n\u003e - LUMC SHARK cluster (nextflow profile name: `zellerlab_shark`)\n\u003e\n\u003e You just need to use the correct profile in the nextflow run so that they are loaded correctly, for example:\n\u003e```bash\n\u003enextflow run zellerlab/flexprofiler -profile zellerlab_shark \u003cYOUR OTHER NEXTFLOW ARGUMENTS\u003e\n\u003e```\n\n\n## Pipeline output\n\nFor more details about the output files and reports, please refer to the\n[output documentation](docs/output.md).\n\n## Credits\n\n**zellerlab/flexprofiler** is developped and maintained by Saul Pierotti.\n**nf-core/taxprofiler** was originally written by James A. Fellows Yates, Sofia Stamouli, Moritz E. Beber, Lili Andersson-Li, and the nf-core/taxprofiler team.\nWe refer the reader to [the pipeline page](https://github.com/nf-core/taxprofiler) for further credits.\n\n### Team\n\n- [Saul Pierotti](https://github.com/saulpierotti)\n\n## Citations\n\nAn extensive list of references for the tools used by the pipeline can be found in the [`CITATIONS.md`](CITATIONS.md) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzellerlab%2Fflexprofiler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzellerlab%2Fflexprofiler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzellerlab%2Fflexprofiler/lists"}