gitlab-download-packages

Download all packages from a GitLab project's package registry.

Features

• Downloads all packages from a GitLab project's package registry
• Supports PyPI and generic package types only
• Works with public registries (no authentication required)
• Organises downloads by package type and name
• Skips existing files (use --overwrite to re-download)
• Python 3.12+ with zero external dependencies

Supported Package Types

This tool only supports downloading:

• PyPI packages (--type pypi)
• Generic packages (--type generic)

Other GitLab package types (Maven, npm, NuGet, etc.) are not supported.

Installation

pip install gitlab-download-packages

Or install from source:

git clone https://gitlab.com/cyberassessmentlabs/public/tools/gitlab-download-packages.git
cd gitlab-download-packages
pip install .

Usage

# Download all packages (PyPI and generic)
gitlab-download-packages \
  --gitlab-url https://gitlab.com \
  --project mygroup/myproject \
  --output ./packages

# Download only PyPI packages
gitlab-download-packages -u https://gitlab.com -p mygroup/myproject -o ./packages -t pypi

# Download only generic packages
gitlab-download-packages -u https://gitlab.com -p mygroup/myproject -o ./packages -t generic

# Overwrite existing files
gitlab-download-packages -u https://gitlab.com -p mygroup/myproject -o ./packages -f

Options

Output Structure

Downloads are organised by package type and name:

packages/
├── pypi/
│   └── package-name/
│       ├── package_name-1.0.0.tar.gz
│       └── package_name-1.0.0-py3-none-any.whl
└── generic/
    └── artifact-name/
        └── artifact-name-1.0.0.zip

Requirements

• Python 3.12 or higher
• No external dependencies (uses only Python standard library)

Development

# Set up development environment
make dev

# Run linting and type checks
make check

# Format code
make format

# Build package and documentation
make build

Licence

MIT License — Copyright (c) 2026 Cyber Assessment Labs