{"id":34077459,"url":"https://github.com/mannlabs/alphapept","last_synced_at":"2025-12-14T10:04:20.027Z","repository":{"id":37927707,"uuid":"244647858","full_name":"MannLabs/alphapept","owner":"MannLabs","description":"A modular, python-based framework for mass spectrometry. Powered by nbdev.","archived":false,"fork":false,"pushed_at":"2024-04-19T15:51:13.000Z","size":213970,"stargazers_count":180,"open_issues_count":26,"forks_count":33,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-10-27T06:48:15.332Z","etag":null,"topics":["alphapept-ecosystem","bioinformatics","mass-spectrometry","proteomics"],"latest_commit_sha":null,"homepage":"https://mannlabs.github.io/alphapept/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MannLabs.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":"docs/contributing.html","funding":null,"license":"LICENSE","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}},"created_at":"2020-03-03T13:48:32.000Z","updated_at":"2025-09-19T13:48:41.000Z","dependencies_parsed_at":"2023-02-12T22:16:43.186Z","dependency_job_id":"3ce80b6e-360b-4e6e-9a9c-48db4c869d7a","html_url":"https://github.com/MannLabs/alphapept","commit_stats":{"total_commits":1618,"total_committers":21,"mean_commits":77.04761904761905,"dds":"0.26823238566131025","last_synced_commit":"843de6b7b560b4ebaefdd9fbe533b65098df3b15"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":"fastai/nbdev_template","purl":"pkg:github/MannLabs/alphapept","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MannLabs%2Falphapept","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MannLabs%2Falphapept/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MannLabs%2Falphapept/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MannLabs%2Falphapept/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MannLabs","download_url":"https://codeload.github.com/MannLabs/alphapept/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MannLabs%2Falphapept/sbom","scorecard":{"id":89394,"data":{"date":"2025-08-11","repo":{"name":"github.com/MannLabs/alphapept","commit":"c81f6f7072cad940aa95328f49d6b6cb6b252669"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.8,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 0/21 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":"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":"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":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/gpu_test.yml:1","Warn: no topLevel permission defined: .github/workflows/nbdev.yaml:1","Warn: no topLevel permission defined: .github/workflows/performance_test_installer.yml:1","Warn: no topLevel permission defined: .github/workflows/publish_on_pypi.yml:1","Warn: no topLevel permission defined: .github/workflows/quick_test.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","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":"Binary-Artifacts","score":1,"reason":"binaries present in source code","details":["Warn: binary detected: alphapept/ext/bruker/FF/linux64/libtbb.so.2:1","Warn: binary detected: alphapept/ext/bruker/FF/linux64/uff-cmdline2:1","Warn: binary detected: alphapept/ext/bruker/FF/win64/tbb.dll:1","Warn: binary detected: alphapept/ext/bruker/FF/win64/uff-cmdline2.exe:1","Warn: binary detected: alphapept/ext/bruker/libtimsdata.so:1","Warn: binary detected: alphapept/ext/bruker/timsdata.dll:1","Warn: binary detected: alphapept/ext/bruker/timsdata.lib:1","Warn: binary detected: alphapept/ext/thermo_fisher/ThermoFisher.CommonCore.Data.dll:1","Warn: binary detected: alphapept/ext/thermo_fisher/ThermoFisher.CommonCore.RawFileReader.dll:1"],"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":"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":"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":"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":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.5.0 not signed: https://api.github.com/repos/MannLabs/alphapept/releases/103792332","Warn: release artifact v0.4.9 not signed: https://api.github.com/repos/MannLabs/alphapept/releases/82561560","Warn: release artifact v0.4.8 not signed: https://api.github.com/repos/MannLabs/alphapept/releases/74697066","Warn: release artifact v0.4.7 not signed: https://api.github.com/repos/MannLabs/alphapept/releases/72427243","Warn: release artifact v0.4.6 not signed: https://api.github.com/repos/MannLabs/alphapept/releases/68310553","Warn: release artifact v0.5.0 does not have provenance: https://api.github.com/repos/MannLabs/alphapept/releases/103792332","Warn: release artifact v0.4.9 does not have provenance: https://api.github.com/repos/MannLabs/alphapept/releases/82561560","Warn: release artifact v0.4.8 does not have provenance: https://api.github.com/repos/MannLabs/alphapept/releases/74697066","Warn: release artifact v0.4.7 does not have provenance: https://api.github.com/repos/MannLabs/alphapept/releases/72427243","Warn: release artifact v0.4.6 does not have provenance: https://api.github.com/repos/MannLabs/alphapept/releases/68310553"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"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":"Vulnerabilities","score":2,"reason":"8 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-6p56-wp2h-9hxr","Warn: Project is vulnerable to: GHSA-fpfv-jqm9-f5jm","Warn: Project is vulnerable to: PYSEC-2024-110 / GHSA-jw8x-6495-233v","Warn: Project is vulnerable to: PYSEC-2023-102","Warn: Project is vulnerable to: GHSA-g7vv-2v7x-gj9p","Warn: Project is vulnerable to: PYSEC-2023-292 / GHSA-9w2p-rh8c-v9g5","Warn: Project is vulnerable to: GHSA-8qw9-gf7w-42x5","Warn: Project is vulnerable to: PYSEC-2024-153 / GHSA-rxff-vr5r-8cj5"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 12 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"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/gpu_test.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/gpu_test.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/nbdev.yaml:7: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/nbdev.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/performance_test_installer.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/performance_test_installer.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_on_pypi.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/publish_on_pypi.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_on_pypi.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/publish_on_pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_on_pypi.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/publish_on_pypi.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_on_pypi.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/publish_on_pypi.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_on_pypi.yml:59: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/publish_on_pypi.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_on_pypi.yml:72: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/publish_on_pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_on_pypi.yml:83: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/publish_on_pypi.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_on_pypi.yml:84: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/publish_on_pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/quick_test.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/quick_test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/release.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/release.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/MannLabs/alphapept/release.yml/master?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating jupyter/base-notebook:python-3.8 to jupyter/base-notebook:python-3.8@sha256:a9cbf18d23e78c23441042501f1a5fa15c3baeae05ccddf6d98dc9624f1d0709","Warn: containerImage not pinned by hash: Dockerfile_bruker:1: pin your Docker image by updating ubuntu:20.04 to ubuntu:20.04@sha256:8feb4d8ca5354def3d8fce243717141ce31e2c428701f6682bd2fafe15388214","Warn: containerImage not pinned by hash: Dockerfile_thermo:1: pin your Docker image by updating jupyter/base-notebook:python-3.8 to jupyter/base-notebook:python-3.8@sha256:a9cbf18d23e78c23441042501f1a5fa15c3baeae05ccddf6d98dc9624f1d0709","Warn: pipCommand not pinned by hash: Dockerfile:24","Warn: pipCommand not pinned by hash: Dockerfile_bruker:6","Warn: pipCommand not pinned by hash: Dockerfile_bruker:13","Warn: pipCommand not pinned by hash: Dockerfile_bruker:14","Warn: pipCommand not pinned by hash: Dockerfile_thermo:23","Warn: pipCommand not pinned by hash: .github/workflows/gpu_test.yml:16","Warn: pipCommand not pinned by hash: .github/workflows/gpu_test.yml:17","Warn: pipCommand not pinned by hash: .github/workflows/gpu_test.yml:18","Warn: pipCommand not pinned by hash: .github/workflows/gpu_test.yml:19","Warn: pipCommand not pinned by hash: .github/workflows/gpu_test.yml:20","Warn: pipCommand not pinned by hash: .github/workflows/performance_test_installer.yml:23","Warn: pipCommand not pinned by hash: .github/workflows/performance_test_installer.yml:24","Warn: pipCommand not pinned by hash: .github/workflows/performance_test_installer.yml:25","Warn: pipCommand not pinned by hash: .github/workflows/quick_test.yml:22","Warn: pipCommand not pinned by hash: .github/workflows/quick_test.yml:23","Warn: pipCommand not pinned by hash: .github/workflows/quick_test.yml:24","Warn: pipCommand not pinned by hash: .github/workflows/quick_test.yml:25","Warn: pipCommand not pinned by hash: .github/workflows/quick_test.yml:26","Info:   0 out of   9 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   6 third-party GitHubAction dependencies pinned","Info:   0 out of   3 containerImage dependencies pinned","Info:   0 out of  18 pipCommand 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-15T07:36:54.073Z","repository_id":37927707,"created_at":"2025-08-15T07:36:54.074Z","updated_at":"2025-08-15T07:36:54.074Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27725947,"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-12-14T02:00:11.348Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["alphapept-ecosystem","bioinformatics","mass-spectrometry","proteomics"],"created_at":"2025-12-14T10:04:15.255Z","updated_at":"2025-12-14T10:04:20.019Z","avatar_url":"https://github.com/MannLabs.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"AlphaPept\n================\n\n\u003c!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! --\u003e\n\n[![nbdev\nCI](https://github.com/MannLabs/alphapept/actions/workflows/nbdev.yaml/badge.svg?branch=master)](https://github.com/MannLabs/alphapept/actions/workflows/nbdev.yaml)\n[![launch -\nrenku](https://renkulab.io/renku-badge.svg)](https://renkulab.io/projects/renku-stories/alphapept-gui-streamlit)\n[![DOI:10.1038/s41467-024-46485-4](http://img.shields.io/badge/DOI-10.1038/s41467-024-46485-4-B31B1B.svg)](https://doi.org/10.1038/s41467-024-46485-4)\n\n![](https://i.imgur.com/xkFtDff.jpg)\n\n**AlphaPept: a modern and open framework for MS-based proteomics**\n\n[Nature Communications](https://doi.org/10.1038/s41467-024-46485-4).\n\nBe sure to check out other packages of our ecosystem:\n\n- [alphatims](https://github.com/MannLabs/alphatims): Fast access to\n  TimsTOF data.\n- [alphamap](https://github.com/MannLabs/alphamap): Peptide level MS\n  data exploration.\n- [alphapeptdeep](https://github.com/MannLabs/alphapeptdeep): Predicting\n  properties from peptides.\n- [alphapeptstats](https://github.com/MannLabs/alphapeptstats):\n  Downstream analysis of MS data\n- [alphaviz](https://github.com/MannLabs/alphaviz): Vizualization of MS\n  data.\n\n## Windows Quickstart\n\n![](https://i.imgur.com/UO64YPx.jpg)\n\n1.  Download the latest installer\n    [here](https://github.com/MannLabs/alphapept/releases/latest),\n    install and click the shortcut on the desktop. A browser window with\n    the AlphaPept interface should open. In the case of Windows Firewall\n    asking for network access for AlphaPept, please allow.\n2.  In the `New Experiment`, select a folder with raw files and FASTA\n    files.\n3.  Specify additional settings such as modifications with `Settings`.\n4.  Click `Start` and run the analysis.\n\nSee also below for more detailed instructions.\n\n## Current functionality\n\n| Feature         | Implemented    |\n|-----------------|----------------|\n| Type            | DDA            |\n| Filetypes       | Bruker, Thermo |\n| Quantification  | LFQ            |\n| Isobaric labels | None           |\n| Platform        | Windows        |\n\nLinux and macOS should, in principle, work but are not heavily tested\nand might require additional work to set up (see detailed instructions\nbelow). To read Thermo files, we use Mono, which can be used on Mac and\nLinux. For Bruker files, we can use Linux but not yet macOS.\n\n## Python Installation Instructions\n\n### Requirements\n\nWe highly recommend the [Anaconda](https://www.anaconda.com) or\n[Miniconda](https://docs.conda.io/en/latest/miniconda.html) Python\ndistribution, which comes with a powerful package manager. See below for\nadditional instructions for Linux and Mac as they require additional\ninstallation of Mono to use the RawFileReader.\n\nAlphaPept can be used as an application as a whole or as a Python\nPackage where individual modules are called. Depending on the use case,\nAlphaPept will need different requirements, and you might not want to\ninstall all of them.\n\nCurrently, we have the default `requirements.txt`, additional\nrequirements to run the GUI `gui` and packages used for developing\n`develop`.\n\nTherefore, you can install AlphaPept in multiple ways:\n\n- The default `alphapept`\n- With GUI-packages `alphapept[gui]`\n- With pacakges for development `alphapept[develop]`\n  (`alphapept[develop,gui]`) respectively\n\nThe requirements typically contain pinned versions and will be\nautomatically upgraded and tested with `dependabot`. This `stable`\nversion allows having a reproducible workflow. However, in order to\navoid conflicts with package versions that are too strict, the\nrequirements are not pinned when being installed. To use the strict\nversion use the `-stable`-flag, e.g. `alphapept[stable]`.\n\nFor end-users that want to set up a processing environment in Python,\nthe `\"alphapept[stable,gui-stable]\"` is the `batteries-included`-version\nthat you want to use.\n\n### Python\n\nIt is strongly recommended to install AlphaPept in its own\nenvironment. 1. Open the console and create a new conda environment:\n`conda create --name alphapept python=3.8` 2. Activate the environment:\n`conda activate alphapept` 3. Install AlphaPept via pip:\n`pip install \"alphapept[stable,gui-stable]\"`. If you want to use\nAlphaPept as a package without the GUI dependencies and without strict\nversion dependencies, use `pip install alphapept`.\n\nIf AlphaPept is installed correctly, you should be able to import\nAlphaPept as a package within the environment; see below.\n\n------------------------------------------------------------------------\n\n#### Linux\n\n1.  Install the build-essentials:\n    `sudo apt-get install build-essential`.\n2.  Install AlphaPept via pip:\n    `pip install \"alphapept[stable,gui-stable]\"`. If you want to use\n    AlphaPept as a package withouth the GUI dependencies and strict\n    version dependencies use `pip install alphapept`.\n3.  Install libgomp.1 with `sudo apt-get install libgomp1`.\n\n##### Bruker Support\n\n4.  Copy-paste the Bruker library for feature finding to your /usr/lib\n    folder with\n    `sudo cp alphapept/ext/bruker/FF/linux64/alphapeptlibtbb.so.2 /usr/lib/libtbb.so.2`.\n\n##### Thermo Support\n\n5.  Install Mono from mono-project website [Mono\n    Linux](https://www.mono-project.com/download/stable/#download-lin).\n    NOTE, the installed mono version should be at least 6.10, which\n    requires you to add the ppa to your trusted sources!\n6.  Install pythonnet with `pip install pythonnet\u003e=2.5.2`\n\n------------------------------------------------------------------------\n\n#### Mac\n\n1.  Install AlphaPept via pip:\n    `pip install \"alphapept[stable,gui-stable]\"`. If you want to use\n    AlphaPept as a package withouth the GUI dependencies and strict\n    version dependencies use `pip install alphapept`.\n\n##### Bruker Support\n\n\u003e Only supported for preprocessed files.\n\n##### Thermo Support\n\n2.  Install [brew](https://brew.sh) and pkg-config:\n    `brew install pkg-config`\n3.  Install Mono from mono-project website [Mono\n    Mac](https://www.mono-project.com/download/stable/)\n4.  Register the Mono-Path to your system: For macOS Catalina, open the\n    configuration of zsh via the terminal:\n\n- Type in `cd` to navigate to the home directory.\n- Type `nano ~/.zshrc` to open the configuration of the terminal\n- Add the path to your mono installation:\n  `export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/usr/lib/pkgconfig:/Library/Frameworks/Mono.framework/Versions/Current/lib/pkgconfig:$PKG_CONFIG_PATH`.\n  Make sure that the Path matches to your version (Here 6.12.0)\n- Save everything and execute `. ~/.zshrc`\n\n4.  Install pythonnet with `pip install pythonnet\u003e=2.5.2`\n\n------------------------------------------------------------------------\n\n#### Developer\n\n1.  Redirect to the folder of choice and clone the repository:\n    `git clone https://github.com/MannLabs/alphapept.git`\n2.  Navigate to the alphapept folder with `cd alphapept` and install the\n    package with `pip install .` (default users) or with\n    `pip install -e .` to enable developers mode. Note that you can use\n    the different requirements here aswell\n    (e.g. `pip install \".[gui-stable]\"`)\n\n#### GPU Support\n\nSome functionality of AlphaPept is GPU optimized that uses Nvidia’s\nCUDA. To enable this, additional packages need to be installed.\n\n1.  Make sure to have a working [CUDA\n    toolkit](https://developer.nvidia.com/cuda-toolkit) installation\n    that is compatible with CuPy. To check type `nvcc --version` in your\n    terminal.\n2.  Install [cupy](https://cupy.dev). Make sure to install the cupy\n    version matching your CUDA toolkit (e.g. `pip install cupy-cuda110`\n    for CUDA toolkit 11.0.\n\n### Additional Notes\n\n\u003e To access Thermo files, we have integrated\n\u003e [RawFileReader](https://planetorbitrap.com/rawfilereader) into\n\u003e AlphaPept. We rely on [Mono](https://www.mono-project.com/) for\n\u003e Linux/Mac systems.\n\n\u003e To access Bruker files, we rely on the `timsdata`-library. Currently,\n\u003e only Windows is supported. For feature finding, we use the Bruker\n\u003e Feature Finder, which can be found in the `ext` folder of this\n\u003e repository.\n\n#### Notes for NBDEV\n\n- For developing with the notebooks, install the nbdev package (see the\n  development requirements)\n- To facilitate navigating the notebooks, use jupyter notebook\n  extensions. They can be called from a running jupyter instance like\n  so: `http://localhost:8888/nbextensions`. The extensions\n  `collapsible headings` and `toc2` are very beneficial.\n\n## Standalone Windows Installer\n\nTo use AlphaPept as a stand-alone program for end-users, it can be\ninstalled on Windows machines via a one-click installer. Download the\nlatest version\n[here](https://github.com/MannLabs/alphapept/releases/latest).\n\n## Docker\n\nIt is possible to run AlphaPept in a docker container. For this, we\nprovide two Dockerfiles: `Dockerfile_thermo` and `Dockerfile_bruker`,\ndepending on which filetypes you want to analyse. They are split because\nof drastically different requirements.\n\nTo run, navigate to the AlphaPept repository and rename the dockerfile\nyou want to use, e.g. `Dockerfile_thermo` to `Dockerfile`.\n\n- Build the image with: `docker build -t docker-alphapept:latest .`\n- To run use\n  `docker run -p 8505:8505 -v /Users/username/Desktop/docker:/home/alphapept/ docker-alphapept:latest alphapept gui`\n  (Note that -v maps a local folder for convient file transfer)\n- Access the AlphaPept GUI via `localhost:8505` in your browser.\n- Note 1: The Thermo Dockerfile is built on a Jupyter image, so you can\n  also start a jupyter instance:\n  `docker run -p 8888:8888 -v /Users/username/Desktop/docker:/home/jovyan/ docker-alphapept:latest jupyter notebook --allow-root`\n\n### Docker Troubleshooting on M1-Mac\n\n- The Thermo dockerfile was tested on an M1-Mac. Resources were set to\n  18GB RAM and 2 CPUs, 200 GB disk\n- It was possible to build the Bruker dockerfile with the platform tag\n  `--platform linux/amd64`. However, it was very slow and the Bruker\n  file is not recommended for an M1-Mac. Windows worked nicely.\n\n## Additional Documentation\n\nThe documentation is automatically built based on the jupyter notebooks\n(nbs/index.ipynb) and can be found\n[here](https://mannlabs.github.io/alphapept/):\n\n## Version Performance\n\nAn overview of the performance of different versions can be found\n[here](https://charts.mongodb.com/charts-alphapept-itfxv/public/dashboards/5f671dcf-bcd6-4d90-8494-8c7f724b727b).\nWe re-run multiple tests on datasets for different versions so that\nusers can assess what changes from version to version. Feel free to\n[suggest](https://github.com/MannLabs/alphapept/discussions) a test set\nin case.\n\n## How to use\n\nAlphaPept is meant to be a framework to implement and test new ideas\nquickly but also to serve as a performant processing pipeline. In\nprinciple, there are three use-cases:\n\n- GUI: Use the graphical user interface to select settings and process\n  files manually.\n- CMD: Use the command-line interface to process files. Useful when\n  building automatic pipelines.\n- Python: Use python modules to build individual workflows. Useful when\n  building customized pipelines and using Python as a scripting language\n  or when implementing new ideas.\n\n### Windows Standalone Installation\n\nFor the [windows\ninstallation](https://github.com/MannLabs/alphapept/releases/latest),\nsimply click on the shortcut after installation. The windows\ninstallation also installs the command-line tool so that you can call\nalphapept via `alphapept` in the command line.\n\n![](https://i.imgur.com/SQikLHQ.jpg)\n\n### Python Package\n\nOnce AlphaPept is correctly installed, you can use it like any other\npython module.\n\n``` python\nfrom alphapept.fasta import get_frag_dict, parse\nfrom alphapept import constants\n\npeptide = 'PEPT'\n\nget_frag_dict(parse(peptide), constants.mass_dict)\n```\n\n    {'b1': 98.06004032687,\n     'b2': 227.10263342687,\n     'b3': 324.15539728686997,\n     'y1': 120.06551965033,\n     'y2': 217.11828351033,\n     'y3': 346.16087661033}\n\n### Using as a tool\n\nIf alphapept is installed an a conda or virtual environment, launch this\nenvironment first.\n\nTo launch the command line interface use: \\* `alphapept`\n\nThis allows us to select different modules. To start the GUI use: \\*\n`alphapept gui`\n\nTo run a workflow, use: \\* `alphapept workflow your_own_workflow.yaml`\nAn example workflow is easily generated by running the GUI once and\nsaving the settings which can be modified on a per-project basis.\n\n### CMD / Python\n\n1.  Create a settings-file. This can be done by changing the\n    `default_settings.yaml` in the repository or using the GUI.\n2.  Run the analysis with the new settings file.\n    `alphapept run new_settings.yaml`\n\nWithin Python (i.e., Jupyter notebook) the following code would be\nrequired)\n\n    from alphapept.settings import load_settings\n    import alphapept.interface\n    settings = load_settings('new_settings.yaml')\n    r = alphapept.interface.run_complete_workflow(settings)\n\nThis also allows you to break the workflow down in indiviudal steps,\ne.g.:\n\n    settings = alphapept.interface.import_raw_data(settings)\n    settings = alphapept.interface.feature_finding(settings)\n\n## Notebooks\n\nWithin the notebooks, we try to cover most aspects of a proteomics\nworkflow:\n\n- Settings: General settings to define a workflow\n- Chem: Chemistry related functions, e.g., for calculating isotope\n  distributions\n- Input / Output: Everything related to importing and exporting and the\n  file formats used\n- FASTA: Generating theoretical databases from FASTA files\n- Feature Finding: How to extract MS1 features for quantification\n- Search: Comparing theoretical databases to experimental spectra and\n  getting Peptide-Spectrum-Matches (PSMs)\n- Score: Scoring PSMs\n- Recalibration: Recalibration of data based on identified peptides\n- Quantification: Functions for quantification, e.g., LFQ\n- Matching: Functions for Match-between-runs\n- Constants: A collection of constants\n- Interface: Code that generates the command-line-interface (CLI) and\n  makes workflow steps callable\n- Performance: Helper functions to speed up code with CPU / GPU\n- Export: Helper functions to make exports compatbile to other Software\n  tools\n- Label: Code for support isobaric label search\n- Display: Code related to displaying in the streamlit gui\n- Additional code: Overview of additional code not covered by the\n  notebooks\n- How to contribute: Contribution guidelines\n- AlphaPept workflow and files: Overview of the worfklow, files and\n  column names\n\n## Contributing\n\nIf you have a feature request or a bug report, please post it either as\nan idea in the\n[discussions](https://github.com/MannLabs/alphapept/discussions) or as\nan issue on the [GitHub issue\ntracker](https://github.com/MannLabs/alphapept/issues). Upvoting\nfeatures in the discussions page will help to prioritize what to\nimplement next. If you want to contribute, put a PR for it. You can find\nmore guidelines for contributing and how to get started\n[here](https://mannlabs.github.io/alphapept/contributing.html). We will\ngladly guide you through the codebase and credit you accordingly.\nAdditionally, you can check out the Projects page on GitHub. You can\nalso contact us via opensource@alphapept.com.\n\nIf you like the project, consider starring it!\n\n## Cite us\n\nIf you use this project in your research, please cite:\n\n\u003e Strauss, M.T., Bludau, I., Zeng, WF. et al. AlphaPept: a modern and\n\u003e open framework for MS-based proteomics. Nat Commun 15, 2168 (2024).\n\u003e https://doi.org/10.1038/s41467-024-46485-4\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmannlabs%2Falphapept","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmannlabs%2Falphapept","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmannlabs%2Falphapept/lists"}