Agent Paranoid Android

Deterministic synthetic test data from CSV and database metadata, without copying source rows. Use the CLI or Python library to profile structure, review a DatasetSpec, generate reproducible datasets, and validate the result.

Stable 1.4.0 is the recommended release. Read the documentation for complete workflows and configuration.

Install And Try It

Python 3.11 or newer is required.

The commands below test release candidate 1.5.0rc1; use 1.4.0 for stable.

python3 -m pip install "agent-paranoid-android==1.5.0rc1"
test-data-agent demo --output out/demo

The offline demo uses a bundled fictional fixture and needs no checkout, network, database, or AI provider. A successful run reports:

Generated synthetic dataset: out/demo | rows: customers=12 | seed: 20260801 | validation: passed | source rows copied: no

The output contains synthetic CSV data, a safe profile, the effective DatasetSpec, a validation report, and a generation manifest. The demo has no relationship or business-rule evidence, so it makes no claim about preserving those properties.

Start With Your Data

CSV and JSON workflows are included in the base package. Install optional database, Parquet, MCP, or AI support only when you need it; see Installation.

Guarantees And Limits

• An explicit seed makes generation reproducible under the recorded package, dependency, locale, and serializer environment.
• Source rows are never copied into generated output. Exact source literals are replaced by default; a field-scoped allowlist can retain only reviewed, bounded, non-sensitive business enums or constants in approved local destinations.
• Database profiling is read-only, allowlisted, and resource-bounded. It does not expose arbitrary unrestricted SQL.
• AI providers are optional. They receive safe metadata, cannot approve a specification, and cannot generate data directly.
• Human review remains required for ambiguous identifiers, free text, inferred relationships, and organization-specific privacy policy.

The project does not certify statistical anonymity, protection from every re-identification attack, or cross-environment byte identity.

Stable 1.4.0 retains the generation and validation corrections from 1.3.2; see migration notes before regenerating existing fixtures.

Choose A Guide

• Review The Output
• Related Tables
• Safety Model
• CLI Command Index
• Troubleshooting

Development

python3 -m pip install "uv==0.11.23"
uv sync --frozen --all-extras --no-install-project
uv sync --frozen --all-extras --no-editable --no-build-isolation
uv run --no-sync scripts/check_release.sh

See Contributing, Support, Governance, Code Of Conduct, Security Policy, Changelog, and License. Releases use PyPI Trusted Publishing with verified wheels and source distributions, checksums, SBOMs, and GitHub attestations.

AI-Assisted Development

AI-assisted changes require human review and tests; never send production data, raw PII, credentials, or tokens to AI. The name nods to Radiohead's "Paranoid Android"; this project is unaffiliated.