---
title: "Build with Philterd"
description: "Quickstarts, runnable samples, and reference docs for the open source PII and PHI redaction toolkit."
url: "https://philterd.ai/dev/"
---

## Philterd for developers

Philterd builds open source software that finds and replaces PII and PHI in text. It runs inside your own infrastructure, so the data you are protecting never leaves your boundary.

## Your first redaction

I want to redact using an API

Philter puts the Phileas engine behind a REST API, with stored policies and an audit trail. It suits several applications sharing one policy set, or callers written in any language.

Philter also runs from the [AWS](https://philterd.ai/dev/start/aws/), [Azure](https://philterd.ai/dev/start/azure/), and [Google Cloud](https://philterd.ai/dev/start/google-cloud/) marketplaces.

```bash
export PHILTER_ENCRYPTION_KEY="$(openssl rand -base64 32)"
export PHILTER_API_KEY="sk_$(openssl rand -hex 16)"

docker run -d --name philter -p 8080:8080 \
  -e PHILTER_ENCRYPTION_KEY \
  -e PHILTER_BOOTSTRAP_API_KEY="$PHILTER_API_KEY" \
  -v philter-data:/opt/philter/data \
  philterd/philter:4.0.1

until curl -skf https://localhost:8080/api/health > /dev/null; do sleep 2; done

curl -sk "https://localhost:8080/api/filter" \
  -H "Authorization: Bearer $PHILTER_API_KEY" \
  -H "Content-Type: text/plain" \
  --data-binary "Contact john@example.com or call about SSN 123-45-6789."
```

```text
Contact {{{REDACTED-email-address}}} or call about SSN {{{REDACTED-ssn}}}.
```

I want to redact in my app

Phileas is the redaction library. It runs in your own process, with no server to deploy:

```bash
pip install phileas-redact
```

```python
from phileas.policy.policy import Policy
from phileas.services.filter_service import FilterService

policy = Policy.from_dict({"name": "demo", "identifiers": {
    "emailAddress": {"emailAddressFilterStrategies": [{"strategy": "REDACT"}]},
    "ssn": {"ssnFilterStrategies": [{"strategy": "REDACT"}]}}})

print(FilterService().filter(
    policy=policy, context="demo", document_id="doc-1",
    text="Contact john@example.com or call about SSN 123-45-6789.",
).filtered_text)
```

```text
Contact {{{REDACTED-email-address}}} or call about SSN {{{REDACTED-ssn}}}.
```

Java and .NET do the same thing. [Walk through all three →](https://philterd.ai/dev/start/)

The full Philter reference is in [Philter’s documentation](https://philterd.github.io/philter/).

Detection is probabilistic. These tools are designed to reduce how much sensitive data passes through a pipeline, and you should validate their output against your own data before relying on them.

## Talk to other developers

[

### Join the Philterd Slack →

Ask questions, talk through an approach before a pull request, and get unstuck with the maintainer and other contributors.

](https://philterd.ai/slack/)

## Where to go

[Your first redaction: Both examples here, step by step: Philter on Docker or your cloud, and Phileas in Python, Java, and .NET.](https://philterd.ai/dev/start/) [Choose a tool: A library, a service, an LLM proxy, or an MCP server.](https://philterd.ai/dev/choose/)

## Latest releases

- [Philter Desktop](https://philterd.ai/philter-desktop/download/) Windows 1.4.0
- [Philter](https://hub.docker.com/r/philterd/philter) docker 4.0.2
- [Philter Diffuse](https://hub.docker.com/r/philterd/philter-diffuse) docker 0.1.0
- [Philter AI Proxy](https://hub.docker.com/r/philterd/philter-ai-proxy) docker 1.0.0
- [Philter Scope](https://hub.docker.com/r/philterd/philter-scope) docker 0.2.0
- [Phileas](https://central.sonatype.com/artifact/ai.philterd/phileas) Java 4.5.0

[All packages →](https://philterd.ai/dev/packages/)
