bdapt (Bundle APT) is a command-line tool for managing collections of APT packages as "bundles" on Debian-based systems (e.g. Ubuntu, Debian, etc.). It lets you install, remove, and track related packages together with a single command.
When software is installed from source or outside your package manager, dependencies often have to be installed manually using apt install. Later, when you remove the software, these dependencies remain because apt autoremove only removes packages marked as "automatically installed." Over time, this leads to clutter and orphaned packages. bdapt solves this by grouping dependencies into bundles, making cleanup straightforward.
Warning
This project is in an early development stage and is not production ready. Expect breaking changes and data loss. Backward compatibility is not guaranteed (i.e. may require manual data migration on updates). Use at your own risk.
You can install bdapt using pip:
pip install bdaptOr if you prefer uv:
uv tool install bdaptLet's say you're setting up a server for a web application. You need Nginx, PostgreSQL, and Redis.
bdapt new web-stack nginx postgresql redis -d "Core web services stack"Your application now requires PHP. Instead of installing it manually, add it to your bundle.
bdapt add web-stack php-fpm php-pgsqlYou've decided to move Redis to a different server and no longer need it locally.
bdapt rm web-stack redisYou are decommissioning the server and want to clean up everything.
bdapt del web-stackNow your system is clean!
Usage: bdapt [OPTIONS] COMMAND [ARGS]...
Bundle APT: Group multiple Debian APT packages as bundles.
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --version Show version and exit │
│ --quiet -q Minimal output │
│ --non-interactive -y Skip all confirmation prompts │
│ --install-completion Install completion for the current shell. │
│ --show-completion Show completion for the current shell, to copy it or customize the installation. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ new Create and install new bundle. │
│ add Add packages to a bundle. │
│ rm Remove packages from a bundle. │
│ del Delete the bundle. │
│ ls List all bundles. │
│ show Display bundle contents. │
│ sync Force reinstall bundle to match definition. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯