Skip to content

Installation

The universal installer sets up an isolated environment with all vault backends included.

macOS / Linux

curl -sSL https://raw.githubusercontent.com/jainal09/envdrift/main/install.sh | sh

Or with options:

# Skip agent binary download
curl -sSL https://raw.githubusercontent.com/jainal09/envdrift/main/install.sh | sh -s -- --no-agent

# Install a specific version
curl -sSL https://raw.githubusercontent.com/jainal09/envdrift/main/install.sh | sh -s -- --version 1.2.3

# Uninstall
curl -sSL https://raw.githubusercontent.com/jainal09/envdrift/main/install.sh | sh -s -- --uninstall

Windows (PowerShell)

irm https://raw.githubusercontent.com/jainal09/envdrift/main/install.ps1 | iex

Or with options (use environment variables when piping):

# Skip agent binary download
$env:ENVDRIFT_NO_AGENT = "1"; irm https://raw.githubusercontent.com/jainal09/envdrift/main/install.ps1 | iex

# Install a specific version
$env:ENVDRIFT_VERSION = "1.2.3"; irm https://raw.githubusercontent.com/jainal09/envdrift/main/install.ps1 | iex

# Uninstall
$env:ENVDRIFT_UNINSTALL = "1"; irm https://raw.githubusercontent.com/jainal09/envdrift/main/install.ps1 | iex

If running the script directly (saved locally), you can use parameters instead:

.\install.ps1 -NoAgent
.\install.ps1 -Version 1.2.3
.\install.ps1 -Uninstall

What the Installer Does

  1. Detects your platform (OS and architecture)
  2. Finds Python 3.11+ on your system
  3. Creates an isolated virtual environment at ~/.envdrift/venv
  4. Installs envdrift[vault] (all vault backends)
  5. Creates a wrapper script at ~/.envdrift/bin/envdrift
  6. Optionally downloads the envdrift-agent binary (with checksum verification)

Add ~/.envdrift/bin to your PATH to use envdrift from anywhere.

pip Install

pip install envdrift
# or with uv
uv add envdrift

Optional Dependencies

envdrift has optional features that require additional packages:

Vault Backends

# Azure Key Vault
pip install envdrift[azure]

# AWS Secrets Manager
pip install envdrift[aws]

# HashiCorp Vault
pip install envdrift[hashicorp]

# GCP Secret Manager
pip install envdrift[gcp]

# All vault backends
pip install envdrift[vault]

Pre-commit Integration

pip install envdrift[precommit]

Everything

pip install envdrift[all]

Verify Installation

envdrift version
# Output: envdrift 0.1.0

Requirements

  • Python 3.11 or higher
  • pydantic >= 2.0
  • pydantic-settings >= 2.0