Metadata-Version: 2.4
Name: ethyca-fides
Version: 2.81.2b0
Summary: Open-source ecosystem for data privacy as code.
Project-URL: Homepage, https://github.com/ethyca/fides
Author-email: "Ethyca, Inc." <fidesteam@ethyca.com>
License: Apache License 2.0
License-File: LICENSE
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: <4,>=3.13
Requires-Dist: acryl-datahub==1.3.1.3
Requires-Dist: aiodns~=3.5.0
Requires-Dist: aiohappyeyeballs~=2.6.1
Requires-Dist: alembic==1.8.1
Requires-Dist: anyascii==0.3.2
Requires-Dist: anyio==3.7.1
Requires-Dist: apscheduler==3.9.1.post1
Requires-Dist: asyncpg==0.30.0
Requires-Dist: attrs~=25.4.0
Requires-Dist: boto3==1.41.2
Requires-Dist: cachecontrol~=0.14.4
Requires-Dist: celery-redis-cluster~=0.2.3
Requires-Dist: celery==5.5.3
Requires-Dist: certifi==2024.8.30
Requires-Dist: cffi~=2.0.0
Requires-Dist: click-default-group==1.2.2
Requires-Dist: click-didyoumean~=0.3.1
Requires-Dist: click-plugins~=1.1.1
Requires-Dist: click-repl~=0.3.0
Requires-Dist: click==8.1.7
Requires-Dist: cloud-sql-python-connector==1.9.2
Requires-Dist: cloudpickle~=3.1.2
Requires-Dist: colorama~=0.4.6
Requires-Dist: cryptography~=46.0.5
Requires-Dist: dask==2025.11.0
Requires-Dist: deepdiff==8.6.1
Requires-Dist: defusedxml==0.7.1
Requires-Dist: ecdsa~=0.19.1
Requires-Dist: email-validator~=2.3.0
Requires-Dist: expandvars==0.9.0
Requires-Dist: fastapi-cli~=0.0.16
Requires-Dist: fastapi-pagination[sqlalchemy]==0.15.0
Requires-Dist: fastapi[all]==0.123.3
Requires-Dist: fideslang==3.1.4a1
Requires-Dist: fideslog==1.2.15
Requires-Dist: filelock~=3.20.0
Requires-Dist: firebase-admin==5.3.0
Requires-Dist: flower==2.0.1
Requires-Dist: gitpython==3.1.41
Requires-Dist: google-auth==2.48.0
Requires-Dist: httpx~=0.28.1
Requires-Dist: iab-tcf==0.2.2
Requires-Dist: immutables==0.21
Requires-Dist: importlib-resources==5.12.0
Requires-Dist: jinja2==3.1.6
Requires-Dist: joblib==1.3.2
Requires-Dist: joserfc~=1.6.3
Requires-Dist: loguru==0.7.3
Requires-Dist: msgpack~=1.1.2
Requires-Dist: multidimensional-urlencode==0.0.4
Requires-Dist: networkx==3.1
Requires-Dist: nh3==0.2.15
Requires-Dist: numpy~=2.3.5
Requires-Dist: oauthlib==3.3.1
Requires-Dist: objgraph==3.6.0
Requires-Dist: okta==3.1.0
Requires-Dist: onepassword-sdk==0.3.0
Requires-Dist: openpyxl==3.0.9
Requires-Dist: ordered-set==4.1.0
Requires-Dist: packaging==23.0
Requires-Dist: paramiko==3.4.1
Requires-Dist: passlib[bcrypt]==1.7.4
Requires-Dist: pg8000==1.31.5
Requires-Dist: platformdirs~=4.5.0
Requires-Dist: psycopg2-binary==2.9.11
Requires-Dist: pyahocorasick==2.1.0
Requires-Dist: pydantic-settings==2.3.3
Requires-Dist: pydantic==2.12.4
Requires-Dist: pydash~=8.0.2
Requires-Dist: pygtrie==2.5.0
Requires-Dist: pyinstrument==4.5.1
Requires-Dist: pyjwt~=2.10.0
Requires-Dist: pymongo[srv]==4.7.3
Requires-Dist: pymysql==1.1.1
Requires-Dist: pyopenssl~=25.3.0
Requires-Dist: python-dateutil~=2.9.0.post0
Requires-Dist: redis==7.2.0
Requires-Dist: requests-oauth2client>=1.5.0
Requires-Dist: requests-oauthlib==2.0.0
Requires-Dist: requests~=2.32.5
Requires-Dist: rfc3986~=2.0.0
Requires-Dist: rich-click==1.9.0
Requires-Dist: rsa~=4.9.1
Requires-Dist: scylla-driver==3.29.7
Requires-Dist: sendgrid==6.9.7
Requires-Dist: setuptools~=80.10.2
Requires-Dist: slowapi==0.1.9
Requires-Dist: smart-open[gcs,s3]==7.3.0.post1
Requires-Dist: smmap~=5.0.2
Requires-Dist: sniffio~=1.3.1
Requires-Dist: snowflake-connector-python~=4.3.0
Requires-Dist: snowflake-sqlalchemy~=1.8.2
Requires-Dist: sqlakeyset~=2.0.1762907931
Requires-Dist: sqlalchemy-bigquery==1.16.0
Requires-Dist: sqlalchemy-citext==1.8.0
Requires-Dist: sqlalchemy-redshift==0.8.11
Requires-Dist: sqlalchemy-stubs==0.4
Requires-Dist: sqlalchemy-utils==0.38.3
Requires-Dist: sqlalchemy[asyncio]==1.4.27
Requires-Dist: sshtunnel==0.4.0
Requires-Dist: starlette~=0.50.0
Requires-Dist: stream-zip==0.0.83
Requires-Dist: tenacity~=9.1.2
Requires-Dist: tinycss2>=1.5.0
Requires-Dist: toml==0.10.2
Requires-Dist: tornado~=6.5.2
Requires-Dist: twilio==7.15.0
Requires-Dist: typer==0.20.0
Requires-Dist: types-defusedxml==0.7.0.20240218
Requires-Dist: typing-extensions==4.14.1
Requires-Dist: urllib3~=2.6.3
Requires-Dist: uvicorn[standard]~=0.30.0
Requires-Dist: yarl~=1.22.0
Provides-Extra: all
Requires-Dist: pymssql==2.3.13; extra == 'all'
Provides-Extra: mssql
Requires-Dist: pymssql==2.3.13; extra == 'mssql'
Description-Content-Type: text/markdown

# Meet Fides: Privacy as Code

[![Latest Release Version][release-image]][release-url]
[![Docker][docker-workflow-image]][docker-actions-url]
[![Docs][docs-workflow-image]][docs-actions-url]
[![Package][release-workflow-image]][publish-actions-url]
[![License][license-image]][license-url]
[![Code style: black][black-image]][black-url]
[![Checked with mypy][mypy-image]][mypy-url]
[![Twitter][twitter-image]][twitter-url]
[![Coverage](https://codecov.io/github/ethyca/fides/coverage.svg?branch=main)](https://codecov.io/gh/ethyca/fides)

![Fides banner](docs/fides/docs/img/fides-banner.png "Fides banner")

## :zap: Overview

Fides (pronounced */fee-dhez/*, from Latin: Fidēs) is an open-source privacy engineering platform for managing the fulfillment of data privacy requests in your runtime environment, and the enforcement of privacy regulations in your code.

## :rocket: Quick Start

### Getting Started

In order to get started quickly with Fides, a sample project is bundled within the Fides CLI that will set up a server, privacy center, and a sample application for you to experiment with.

#### Minimum requirements (for all platforms)

* [Docker](https://www.docker.com/products/docker-desktop) (version 20.10.11 or later)
* [Python](https://www.python.org/downloads/) (version 3.13)
* [uv](https://docs.astral.sh/uv/)

#### Download and install Fides

> [!TIP]
> We highly recommend using `uv` to install Fides and manage a virtual environment.
>
> To download `uv`:
> - macOS/Linux: `curl -LsSf https://astral.sh/uv/install.sh | sh`
> -  Windows: `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"`

You can then easily download and install Fides using `uv`. Run the following command to get started:

```
uv pip install ethyca-fides
```

#### Deploy the Fides sample project

By default, Fides ships with a small project belonging to a fictional e-commerce store. Running the `fides deploy up` command builds a Fides project with all you need to run your first Data Subject Request against real databases.

```sh
uv run fides deploy up
```

#### Explore the sample project

When your deployment finishes, a welcome screen will explain the key components of Fides and the sample "Cookie House" project.

If your browser does not open automatically, you should navigate to <http://localhost:3000/landing>.

The project contains:

* The Fides Admin UI for managing privacy requests
* The Fides [Privacy Center](https://ethyca.com/docs/dev-docs/privacy-requests/privacy-center) for submitting requests
* The sample "Cookie House" eCommerce site for testing
* A DSR Directory on your computer to view results (`./fides_uploads`)

#### Run your first Privacy Access Request

Navigate to the Fides Privacy Center (<http://localhost:3001>), submit a "Download your data" request, provide the email address for the sample user (`jane@example.com`), and submit the request.

Then, navigate to the Fides Admin UI (<http://localhost:8080>) to review the pending privacy request.

Use username `root_user` and password `Testpassword1!` to login, approve the request, and review the resulting package in your `./fides_uploads` folder!

### Next Steps

Congratulations! You've just run an entire privacy request in under 5 minutes! Fides offers many more tools to help take control of your data privacy. To find out more, you can run a privacy request on [your own infrastructure](https://ethyca.com/docs/tutorials/privacy-requests), discover [data mapping](https://ethyca.com/docs/tutorials/data-mapping), or learn about the [Fides Taxonomy](https://ethyca.github.io/fideslang/).

## :book: Learn More

The Fides core team is committed to providing a variety of documentation to help get you started using Fides.  As such, all interactions are governed by the [Fides Code of Conduct](https://ethyca.com/docs/community/code_of_conduct).

### Documentation

For more information on getting started with Fides, how to configure and set up Fides, and more about the Fides ecosystem of open source projects:

* Documentation: <https://ethyca.com/docs>
* Website: www.ethyca.com/fides

### Support

Join the conversation on:

* [Slack](https://fid.es/join-slack)
* [X](https://x.com/ethyca)
* [Discussions](https://github.com/ethyca/fides/discussions)

### Contributing

We welcome and encourage all types of contributions and improvements!  Please see our [contribution guide](https://ethyca.com/docs/community) to opening issues for bugs, new features, and security or experience enhancements.

Read about the [Fides community](https://ethyca.com/docs/community/hints_tips) or dive into the [contributor guides](https://ethyca.com/docs/community/development/overview) for information about contributions, documentation, code style, testing and more. Ethyca is committed to fostering a safe and collaborative environment, such that all interactions are governed by the [Fides Code of Conduct](https://ethyca.com/docs/community/code_of_conduct).

## :balance_scale: License

The [Fides](https://github.com/ethyca/fides) ecosystem of tools are licensed under the [Apache Software License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).
Fides tools are built on [fideslang](https://github.com/ethyca/privacy-taxonomy), the Fides language specification, which is licensed under [CC by 4](https://github.com/ethyca/privacy-taxonomy/blob/main/LICENSE).

Fides is created and sponsored by Ethyca: a developer tools company building the trust infrastructure of the internet. If you have questions or need assistance getting started, let us know at fides@ethyca.com!

[release-image]: https://img.shields.io/github/release/ethyca/fides.svg
[release-url]: https://github.com/ethyca/fides/releases
[docker-workflow-image]: https://github.com/ethyca/fides/workflows/Docker%20Build%20&%20Push/badge.svg
[docs-workflow-image]: https://github.com/ethyca/fides/workflows/Publish%20Docs/badge.svg
[release-workflow-image]: https://github.com/ethyca/fides/actions/workflows/publish_package.yaml/badge.svg
[docker-actions-url]: https://github.com/ethyca/fides/actions/workflows/publish_docker.yaml
[docs-actions-url]: https://github.com/ethyca/fides/actions/workflows/publish_docs.yaml
[publish-actions-url]: https://github.com/ethyca/fides/actions/workflows/publish_package.yaml
[license-image]: https://img.shields.io/:license-Apache%202-blue.svg
[license-url]: https://www.apache.org/licenses/LICENSE-2.0.txt
[black-image]: https://img.shields.io/badge/code%20style-black-000000.svg
[black-url]: https://github.com/psf/black/
[mypy-image]: http://www.mypy-lang.org/static/mypy_badge.svg
[mypy-url]: http://mypy-lang.org/
[twitter-image]: https://img.shields.io/twitter/follow/ethyca?style=social
[twitter-url]: https://twitter.com/ethyca

## ⚠️ Advanced Setup for Microsoft SQL Server (MSSQL) Support

By default, running `pip install ethyca-fides` locally will not install the optional Python libraries needed for Microsoft SQL Server, since these rely on additional system dependencies (`freetds`)! However, if you *do* want to connect to MSSQL, you have two options:
1. Use our pre-built Docker images which install these optional dependencies automatically: [`ethyca/fides`](https://hub.docker.com/r/ethyca/fides). See our [Deployment Guide](https://ethyca.com/docs/dev-docs/configuration/deployment) for more!
2. Install the required dependencies on your local development machine and run `pip install "ethyca-fides[all]"` to include "all" the optional libraries. Keep reading to learn more about this!

For local development setup on macOS, follow these steps:
1. Install the required development libraries from Homebrew:
```zsh
brew install freetds openssl
```
2. Add the following to your shell (i.e. `.zshrc`) to ensure your compiler can access the `freetds` and `openssl` libraries, updating the paths & versions to match your local install:
```zsh
export LDFLAGS="-L/opt/homebrew/opt/freetds/lib -L/opt/homebrew/opt/openssl/lib"
export CFLAGS="-I/opt/homebrew/opt/freetds/include"
```
3. Reinstall Fides with MSSQL support by including the `all` extra requirement:
```zsh
uv pip install "ethyca-fides[all]"
```
