Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

alphapepttools

PyPI - Version Tests Documentation Preprint

Search- and quantification-engine agnostic downstream processing of proteomics data

alphapepttools was made to make your life in proteomics easier!

Functionalities are intended to be as close to pure python as possible, avoiding closed end-to-end implementations, which is reflected in several design choices:

  1. AnnData is used in favor of a custom data class to enable interoperability with any other tool from the Scverse.
  2. matplotlib Axes and Figure instances are used for visualization, giving the user full autonomy to layer on custom visualizations with searborn, matplotlib, or any other compatible visualization package.
  3. Statistical and preprocessing functions are standalone and set with strong defaults, meaning that any function can be used outside of the alphapepttools context.

Design choices of alphapepttools:

  • Data handling: AnnData was chosen as a data container for two main reasons:
    1. For presenting a lightweight, powerful solution to a fundamental challenge with dataframes, which is keeping numerical data and metadata aligned together at all times. Using dataframes, the options are to either include non-numeric metadata columns in the dataframe (complicating data operations) or to add cumbersome multi-level indices and
    2. For their compatibility with the Scverse, Scanpy and all associated tools, essentially removing the barrier between proteomics and transcriptomics data analysis and enabling multi-omics analyses.
  • Plotting: Inspired by the stylia package, alphapepttools aims to provide a consistent and aesthetically pleasing visual experience for all plots. A core component of this implementation is the fact that create_figure returns subplots as an iterable data structure, meaning that once the basic layout of a plot is decided, users simply jump from one plot window to the next and populate each one with figure elements.
  • Standardization: A key consideration of this package is the loading of proteomics data, the biggest painpoint of which is the nonstandard output of various proteomic search engines. By building on alphabase, we handle this complexity early and provide the user with AnnData objects containing either proteins or precursors, where the familiar Pandas DataFrame is always just a 'df = adata.to_df().join(adata.obs)' away.

Getting started

Please refer to the documentation, in particular, the API documentation.

Installation

You need to have Python 3.11 or newer installed on your system (Linux/MacOS/Windows). If you don't have Python installed, we recommend installing Mambaforge.

There are several alternative options to install alphapepttools:

  1. Install the latest release of alphapepttools from PyPI:
pip install alphapepttools

As the package is still under development, consider installing the latest development version with the latest changes, features, and bug fixes:

  1. Development version
pip install git+https://github.com/MannLabs/alphapepttools.git@main

For a full list of dependencies, see the dependencies section in the pyproject.toml. Installation should take less than 5 minutes.

Installation extras

Depending on your use case, you might want to install specific versions of packages or additional dependencies.

If you want to use alphapepttools in an isolated environment and enforce stringent dependencies, you can install the stable version:

pip install "alphapepttools[stable]"

Note that this installs only a subset of alphapepttools functionality, as it misses the alphaquant and inmoose packages (required for advanced differential expression analysis). If you encounter a respective warning, you need to install the full extra option

pip install "alphapepttools[full]"  # or [full-stable]

or install the respective packages manually.

For development purposes like running tests, pre-commit hooks, and building the documentation locally, install the optional development dependencies:

git clone https://github.com/MannLabs/alphapepttools.git && cd alphapepttools
pip install -e ".[test, dev]"

Release notes

See the GitHub Release page.

Developer Guide

This document gathers information on how to develop and contribute to the alphapepttools project.

Release process

Tagging of changes

In order to have release notes automatically generated, changes need to be tagged with labels. The following labels are used (should be safe-explanatory): breaking-change, bug, enhancement.

Release a new version

This package uses a shared release process defined in the alphashared repository. Please see the instructions there

Contact

For questions and help requests, you can reach out in the scverse discourse. If you found a bug, please use the issue tracker.

Citation

Brennsteiner, V., Diedrich, L. et al. AlphaPeptTools: scverse-native analysis of mass spectrometry-based proteomics (preprint), bioRxiv (2026).

Metadata

Release files for alphapepttools 0.4.1.dev0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alphapepttools 0.4.1.dev0
File Size Uploaded Provenance Actions
alphapepttools-0.4.1.dev0.tar.gz 13.9 MB With provenance Details for alphapepttools-0.4.1.dev0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for alphapepttools 0.4.1.dev0
File Interpreter ABI Platform Actions
alphapepttools-0.4.1.dev0-py3-none-any.whl Python 3 none any Details for alphapepttools-0.4.1.dev0-py3-none-any.whl

Total release size: 14.1 MB

Release files / alphapepttools-0.4.1.dev0.tar.gz

Download URL alphapepttools-0.4.1.dev0.tar.gz
Size 13.9 MB
Tags Source
SHA-256 checksum
How to use checksums
001c76f59f438e3b3f3e8b5e160807cf22c1325393444ed97587a01e086b0b28
BLAKE2b-256 checksum
How to use checksums
84a0c81b4d47abd47a76a7c28008124c4b785fb3033e0c0ee86d544b15e44666
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Release files / alphapepttools-0.4.1.dev0-py3-none-any.whl

Download URL alphapepttools-0.4.1.dev0-py3-none-any.whl
Size 151.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4953c51ad34e31de0ec3ce3671a21358a3eafd1493932415f5f629286cb20d63
BLAKE2b-256 checksum
How to use checksums
a68358a310f9ac2e4a2bd1e5dd4b96c9308f1de332a704a4e5fa5a74484c03b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

Security for alphapepttools 0.4.1.dev0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for alphapepttools-0.4.1.dev0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page