Skip to main content

Installation

Requirements​

  • Python >= 3.11
  • pip

Install from PyPI​

pip install driftguard-ai

Install the spaCy model​

DriftGuard uses spaCy for text normalization. After installing the package, download the model:

python -m spacy download en_core_web_sm

Optional extras​

Install test dependencies:

pip install "driftguard-ai[test]"

Install LangGraph demo dependencies:

pip install "driftguard-ai[demo]"

Install Postgres persistence dependencies:

pip install "driftguard-ai[postgres]"

Install everything for local development:

pip install "driftguard-ai[dev]"

Verify the install​

from driftguard import DriftGuard

guard = DriftGuard()
print(guard.stats())
# → {'mistakes': {'nodes': 0, 'edges': 0}, 'successes': {'nodes': 0, 'edges': 0}}

Entry points​

Two CLI commands are installed automatically:

driftguard-mcp        # start the MCP server
driftguard-benchmark  # run the quality benchmark suite