{"id":22621078,"url":"https://github.com/pdimens/gust","last_synced_at":"2025-07-22T09:09:13.271Z","repository":{"id":154347861,"uuid":"429576167","full_name":"pdimens/gust","owner":"pdimens","description":"An easy breezy whole-genome derived snp-based phylogenetic pipeline 🌪️","archived":false,"fork":false,"pushed_at":"2022-06-07T16:26:55.000Z","size":1409,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-02T20:10:23.534Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pdimens.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-18T20:51:50.000Z","updated_at":"2022-02-15T14:34:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"d7577ca0-bd98-4693-921d-20b75d514799","html_url":"https://github.com/pdimens/gust","commit_stats":{"total_commits":84,"total_committers":1,"mean_commits":84.0,"dds":0.0,"last_synced_commit":"54f932c363933aa5370ac82e114ce82141e3dea2"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/pdimens/gust","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdimens%2Fgust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdimens%2Fgust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdimens%2Fgust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdimens%2Fgust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pdimens","download_url":"https://codeload.github.com/pdimens/gust/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdimens%2Fgust/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266463008,"owners_count":23932893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2024-12-08T22:17:37.720Z","updated_at":"2025-07-22T09:09:13.233Z","avatar_url":"https://github.com/pdimens.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![gust logo](.other/gust.svg)](https://github.com/pdimens/gust/blob/main/README.md#installation)\n\nAn easy breezy whole-genome derived snp-based phylogenetic pipeline 🌪️ \n\n[![Cite](https://img.shields.io/badge/Cite-10.5281/zenodo.6077896-e1e1e1?style=for-the-badge)](https://zenodo.org/badge/latestdoi/429576167) \n\n\n## Installation\n### Pre-requisites\n1. Any kind of conda environment \n    - `anaconda`, `miniconda`, `micromamba`\n    - I recommend `mamba`\n3. A `git` installation (optional)\n4. Linux system\n\n### 1. Clone this repository\nEverything you'll need is right here in this repository, which will also be your project directory. You'll need to clone\nthis repository for every new project (it's very lightweight). Feel free to rename the `gust` folder to whatever is relevant for your project.\n\n#### with `git` (recommended)\n```bash\ngit clone https://github.com/pdimens/gust.git\n```\n#### without `git`\n```bash\nwget -O gust.zip https://github.com/pdimens/gust/archive/refs/heads/main.zip\nunzip gust.zip  # or whatever archive extractor you have\n```\n\n### 2. Initiate the `gust` conda environment \n🌪️ **if you already have a `gust` conda environment, skip this step** 🌪️\n\nUse the provided `gust_env.yaml` conda configuration file to create a new conda environment. If not using `conda`, replace `conda` with the appropriate environment framework, (`mamba`, `micromamba`, etc.)\n\n```bash\ncd gust   # enter the gust directory\nconda env create -f .other/gust_env.yaml\n```\nThis will create a new environment called `gust` containing all the software dependencies. Activate the environment with:\n```bash\nconda activate gust\n```\n\n## Usage\n### Preparation\nIt's minimal, I swear.\n1. Put all of the genomes you want included in analysis in the `genomes` folder\n    - **make sure the files end with `.fasta`**\n    - I haven't figured out how to make snakemake more flexible with this (PR's welcome!)\n2. Specify the name of the reference genome and outgroup genome in `config.yml`\n    - the genomes should be in the `genomes/` folder\n    - use **just** the name, not the full path\n    - e.g. `\"bostauros.fasta\"` ✅  vs `\"genomes/bostauros.fasta\"` ❌\n3. [optional] Modify software parameters in `config.yml`\n\n### Running\n- activate the `gust` environment with `conda activate gust`\n\nIf you call `gust` without arguments you will see help text, otherwise:\n```bash\n./gust numThreads configFile\n```\nwhere `numThreads` is the number of threads to use (\u003e1, no default) and\n`configFile` is the name of the configuration file (optional, defaults to `config.yml`).\n#### examples\nRunning `gust` with 25 threads using the configuration file `config.yml`\n```bash\n./gust 25\n```\nRunning `gust` with 10 threads using the configuration file `frag250.yml`\n```bash\n./gust 10 frag250.yml\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpdimens%2Fgust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpdimens%2Fgust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpdimens%2Fgust/lists"}