Fides - Data Privacy as Code

2.84.5 verified Sat May 09 auth: no python

Fides is an open-source ecosystem for data privacy as code, providing tools for privacy engineering, data mapping, consent management, and privacy request automation. Version 2.84.5 supports Python 3.13+ only. Releases are frequent (multiple per month).

pip install ethyca-fides

Common errors

error ModuleNotFoundError: No module named 'fides' ↓

cause Fides is not installed or installed in wrong Python environment.

fix

Run pip install ethyca-fides and ensure you are using Python 3.13+.

error RuntimeError: The current Python version (<3.13) is not supported by Fides. ↓

cause Fides requires Python 3.13+. Older Python versions are not supported.

fix

Upgrade Python to 3.13 or newer.

error ImportError: cannot import name 'FidesConfig' from 'fides.config' ↓

cause Configuration classes have been moved to fides.core.config.

fix

Use from fides.core.config import FidesConfig.

Warnings

breaking Fides 2.x requires Python 3.13+ only. Install on older Python will fail. ↓

fix Upgrade Python to 3.13 or newer.

gotcha The main FastAPI application is imported from `fides.api.main`, not `fides` directly. Common mistake leads to import errors. ↓

fix Use `from fides.api.main import app`.

deprecated Direct use of `fides.config` module is deprecated; configuration classes moved to `fides.core.config`. ↓

fix Use `from fides.core.config import FidesConfig`.

Imports

FidesApp
wrong
```
from fides import app
```
correct
```
from fides.api.main import app
```
The FastAPI app instance lives in fides.api.main, not top-level fides.

Config

wrong

from fides.config import FidesConfig

correct

from fides.core.config import FidesConfig

Config module moved to fides.core.config in recent releases.

privacy_request

wrong

from fides.models.privacy_request import PrivacyRequest

correct

from fides.api.ops.models.privacy_request import PrivacyRequest

Models are under fides.api.ops.models.

Quickstart

Minimal setup to run the Fides API server. Set required environment variables before importing the app.

from fides.api.main import app
import os

# Example: configure database URL via environment variable
os.environ.setdefault('FIDES__DATABASE__SERVER', 'localhost')
os.environ.setdefault('FIDES__DATABASE__USER', 'fides')
os.environ.setdefault('FIDES__DATABASE__PASSWORD', 'fides')
os.environ.setdefault('FIDES__DATABASE__DB', 'fides')

# Access the FastAPI app instance
@app.get("/health")
async def health():
    return {"status": "ok"}

# Run with: uvicorn fides.api.main:app --reload