Skip to content

Improve readme and re-add Docker#301

Merged
mschwoer merged 7 commits intomainfrom
improve_readme
Oct 29, 2025
Merged

Improve readme and re-add Docker#301
mschwoer merged 7 commits intomainfrom
improve_readme

Conversation

@mschwoer
Copy link
Contributor

Bringt Readme and Dockerfile to latest standard, adds Docker publishing workflow

@mschwoer mschwoer changed the title Improve readme Improve readme and re-add Docker Aug 22, 2025
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR modernizes AlphaTims' README and Docker configuration to current standards. It improves the project's documentation structure and adds Docker publishing capabilities for better distribution and deployment workflows.

  • Restructures README with improved navigation, installation instructions, and visual elements
  • Updates Docker configuration for better security practices and modern Python base image
  • Adds automated Docker image publishing workflow

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
pyproject.toml Updates project metadata including keywords ordering, URL structure, and repository references
README.md Major restructuring with new logo section, improved installation guides, and reorganized content
Dockerfile Modernizes Docker setup with security best practices and updated base image
CHANGELOG.md Extracts historical changelog from README into dedicated file
.github/workflows/publish_docker_image.yml Adds automated Docker image publishing workflow

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

"proteomics",
"bioinformatics",
"data indexing",
"AlphaPept",
Copy link

Copilot AI Aug 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The keywords list contains duplicate 'AlphaPept' entries. Line 22 has 'AlphaPept' and line 23 has 'AlphaPept ecosystem', which creates redundancy in the keywords.

Copilot uses AI. Check for mistakes.
README.md Outdated
* [**One-click GUI installation:**](#one-click-gui-installation) Choose this installation if you only want the GUI and/or keep things as simple as possible.
* [**Pip installation:**](#pip-installation) Choose this installation if you want to use AlphaTims as a Python package in an existing Python 3.8 environment (e.g. a Jupyter notebook). If needed, the GUI and CLI can be installed with pip as well.
* [**Developer installation:**](#developer-installation) Choose this installation if you are familiar with CLI tools, [conda](https://docs.conda.io/en/latest/) and Python. This installation allows access to all available features of AlphaTims and even allows to modify its source code directly. Generally, the developer version of AlphaTims outperforms the precompiled versions which makes this the installation of choice for high-throughput experiments.
* [**Docker installation:**](#docker-installation) Use this installation if you want to use a container based workflow. This is usefull to preserve a clean environment or when running multiple tools that might have conflicting dependencies. -->
Copy link

Copilot AI Aug 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a typo in 'usefull' which should be 'useful'. Also, there's a stray HTML comment closing tag '-->' at the end of the line.

Suggested change
* [**Docker installation:**](#docker-installation) Use this installation if you want to use a container based workflow. This is usefull to preserve a clean environment or when running multiple tools that might have conflicting dependencies. -->
* [**Docker installation:**](#docker-installation) Use this installation if you want to use a container based workflow. This is useful to preserve a clean environment or when running multiple tools that might have conflicting dependencies.

Copilot uses AI. Check for mistakes.
README.md Outdated
This is indicated by a dialog telling you `“alphatims. ... .pkg” Not Opened`.
1. Close this dialog by clicking `Done`.
2. Choose `Apple menu` > `System Settings`, then `Privacy & Security` in the sidebar. (You may need to scroll down.)
3. Go to `Security`, locate the line "alphadia.pkg was blocked to protect your Mac" then click `Open Anyway`.
Copy link

Copilot AI Aug 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The package name should be 'alphatims.pkg' not 'alphadia.pkg' to match the correct package being installed.

Suggested change
3. Go to `Security`, locate the line "alphadia.pkg was blocked to protect your Mac" then click `Open Anyway`.
3. Go to `Security`, locate the line "alphatims.pkg was blocked to protect your Mac" then click `Open Anyway`.

Copilot uses AI. Check for mistakes.
Dockerfile Outdated
# to allow other host ports than 5006
ENV BOKEH_ALLOW_WS_ORIGIN=localhost

#USER alphatimsuser
Copy link

Copilot AI Aug 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The USER directive is commented out, which means the container will run as root. This violates security best practices. The container should run as the non-privileged 'alphatimsuser' that was created.

Suggested change
#USER alphatimsuser
USER alphatimsuser

Copilot uses AI. Check for mistakes.
@mschwoer mschwoer merged commit da4f468 into main Oct 29, 2025
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant