Installation¶

dotenv-fusion requires Python 3.10 or newer. Package installations include all official backends and keep the core dependency-free.

pipuv projectuv tooluvxGitLab source

pip install dotenv-fusion

uv add dotenv-fusion

uv tool install dotenv-fusion

uvx dotenv-fusion --help

uvx git+https://gitlab.com/pytgaen-group/dotenv-fusion --help

Standalone CLI¶

The standalone script is useful on machines where installing a package is not practical. Pin a release tag for reproducible installation:

DOTENV_FUSION_REF=0.6.0
install -d ~/.local/bin
curl -fsSLo ~/.local/bin/dotenv-fusion \
  "https://gitlab.com/pytgaen-group/dotenv-fusion/-/raw/${DOTENV_FUSION_REF}/src/dotenv_fusion/dotenvfusion.py"
chmod +x ~/.local/bin/dotenv-fusion

The standalone core does not include optional backend sidecars. Install the age sidecar only when the configuration uses age:// sources, and use the same release ref as the core:

install -d ~/.local/lib/dotenv-fusion/backends
curl -fsSLo ~/.local/lib/dotenv-fusion/backends/age.py \
  "https://gitlab.com/pytgaen-group/dotenv-fusion/-/raw/${DOTENV_FUSION_REF}/src/dotenv_fusion/backends/age.py"

The age executable must also be installed through the operating system. Set DOTENV_FUSION_BACKEND_PATH to an absolute directory only when sidecars live somewhere other than the default location.

Verify the installation¶

dotenv-fusion --help
dotenv-fusion check --help

Continue with the Quick Start.