Installation

Requirements

• Python 3.12 or higher

---

With uv (Recommended)

uv is the recommended way to install env-grep as a global CLI tool:

uv tool install env-grep

This installs env-grep in an isolated environment managed by uv, making both env-grep and evg available system-wide without touching your project's dependencies.

---

With pip

Install inside a virtual environment:

pip install env-grep

Warning

Avoid installing into your system Python directly. Always activate a virtual environment first.

---

Verify the Installation

env-grep --help
evg scan --help

---

Upgrading

# With uv
uv tool upgrade env-grep

# With pip
pip install --upgrade env-grep