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.5.0 is the recommended release. Read the documentation for complete workflows and configuration.

Prospective candidate 1.6.0rc3 is not yet published (feedback corrections). Candidate 1.6.0rc2 is published; see the release evidence. Stable 1.5.0 remains the recommended release. The explicit candidate pin is:

python3 -m pip install "agent-paranoid-android==1.6.0rc3"

Install And Try It

Python 3.11 or newer is required.

The commands below install the exact stable release.

python3 -m pip install "agent-paranoid-android==1.5.0"
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.5.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

The 1.6 development candidate includes an isolated saved-profile transformation workflow, not an available command in the published 1.5.0 package. Public common CLI/MCP activation remains gated by completed candidate checks and independent safety review. See the candidate CLI contract and acceptance evidence. Ordinary generation remains source-free; agents cannot issue preservation approval.

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.

Agents can use the portable project workflow map and selective-transformation guide. These skills work offline with installed command help; they do not grant permissions or enable unfinished features. Agents that do not discover .agents/skills automatically can load either SKILL.md directly. Both are also included in the installed wheel under test_data_agent/skills; find that directory with:

python -c 'from importlib.resources import files; print(files("test_data_agent").joinpath("skills"))'

Point the agent at the selected skill directory using its own configuration; installing this package does not silently register skills with other agents.