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

Install And Try It

Python 3.11 or newer is required.

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

Source	Start here
One CSV file	First CSV Dataset
PostgreSQL	PostgreSQL Workflow
Trino	Trino Workflow
Existing `DatasetSpec`	Profiles And Specs

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.

Choose A Guide

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_paranoid_android-1.3.1.tar.gz (932.2 kB view details)

Uploaded Aug 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

agent_paranoid_android-1.3.1-py3-none-any.whl (239.4 kB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file agent_paranoid_android-1.3.1.tar.gz.

File metadata

Download URL: agent_paranoid_android-1.3.1.tar.gz
Upload date: Aug 22, 2026
Size: 932.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent_paranoid_android-1.3.1.tar.gz
Algorithm	Hash digest
SHA256	`2842212040d65d16cbf25c1036fc5eed92708b6f8b5fb75c2add849f21344dea`
MD5	`74be4ae86fb77d8aac12d246dd610203`
BLAKE2b-256	`f43c78585d976b52487187415e2ffa67d99308afb91c7c1ff032e7af44d67efd`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_paranoid_android-1.3.1.tar.gz:

Publisher: publish-pypi.yml on wa-pis/agent-paranoid-android

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agent_paranoid_android-1.3.1.tar.gz
- Subject digest: 2842212040d65d16cbf25c1036fc5eed92708b6f8b5fb75c2add849f21344dea
- Sigstore transparency entry: 2556734767
- Sigstore integration time: Aug 22, 2026
Source repository:
- Permalink: wa-pis/agent-paranoid-android@d0ccd79e5dfceed84868f86b9404431af6758ead
- Branch / Tag: refs/tags/v1.3.1
- Owner: https://github.com/wa-pis
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@d0ccd79e5dfceed84868f86b9404431af6758ead
- Trigger Event: workflow_dispatch