Skip to main content

DataNyx

Let an AI agent work with your data without ever seeing it.

DataNyx turns files and databases into value-free schemas an agent can write code against, and replaces names and identifiers in free text with placeholders.

License: MIT Python 3.10+ Code style: ruff Types: mypy

Getting started · Documentation · Command reference · Security model · Changelog


You want an agent to write a report, a query or a data-cleaning script, but the data is customers, patients or payroll. Pasting rows into a chat is a leak, and describing the columns by hand is tedious. DataNyx sits in between:

What the agent gets What it never gets
Structured data
datanyx schema
Field names, types, formats, nesting, primary and foreign keys Values, examples, enum labels, counts or statistics
Free text
datanyx anonymize
The text with <PERSON_1>, <EMAIL_1> and friends in place of identifiers The identifiers themselves (best effort: review the result)

A first look

$ datanyx schema customers.csv --format text
root: array<{
  id: integer
  email: string<email>
  signed_up: string<date>
  plan: string
  lifetime_value: number
  notes: string | null
}>

$ datanyx anonymize call-notes.txt
<PERSON_1> (<EMAIL_1>) called on <DATE_1> about invoice
<ID_1>. Ms. <PERSON_1> lives in <LOCATION_1>. Her manager <PERSON_2> agreed.

The agent sees the shape of the table and the story in the text, and none of the values. It can also try its code on fake rows generated from the schema.

Install

git clone <this repository> datanyx && cd datanyx
uv sync --all-extras                 # or: pip install -e ".[all]"
datanyx doctor                       # shows which optional packages and models are installed

Python 3.10 or newer. Supported sources lists the extra for each format.

What's in the documentation

Getting started Install, a first schema, a first anonymized text
Schemas, synthetic data The core: what the agent sees instead of the data
Debugging, checking code Fixing code without seeing the data
Scanning, anonymization, pseudonymization, detection quality Finding and hiding personal data
Using it with an agent datanyx protect, the guard hook and the MCP server
Installing and deploying PyPI, Docker, a pre-commit hook, a GitHub Action, a shared MCP server
Team settings, schema diff Shared policy, and change detection for CI
Security model What is guaranteed, what isn't, and the known limits
Command reference, Python API Every option, and use from code
Contributing Architecture, adding a source, tests

To read it as a site: uv sync --group docs then uv run mkdocs serve.

License

MIT © 2026 ludenberg

Metadata

Release files for datanyx 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for datanyx 0.1.0
File Size Uploaded Provenance Actions
datanyx-0.1.0.tar.gz 236.7 kB With provenance Details for datanyx-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for datanyx 0.1.0
File Interpreter ABI Platform Actions
datanyx-0.1.0-py3-none-any.whl Python 3 none any Details for datanyx-0.1.0-py3-none-any.whl

Total release size: 418.1 kB

Release files / datanyx-0.1.0.tar.gz

Download URL datanyx-0.1.0.tar.gz
Size 236.7 kB
Tags Source
SHA-256 checksum
How to use checksums
6c845d4dbd8b311abc1a2e02bf9c8ccf2ab22c07f5946d5532a944d078e8a536
BLAKE2b-256 checksum
How to use checksums
b28c1470ee0f95922b9f6d17eec28c2e7e4ac732e06c9fef375aceadedcdb3b4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Release files / datanyx-0.1.0-py3-none-any.whl

Download URL datanyx-0.1.0-py3-none-any.whl
Size 181.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
379e643e98a8ea6e51e93fbc86e0e9e58d9a780032c11a84c5c7af4fbfb5742d
BLAKE2b-256 checksum
How to use checksums
f145a07a80ef6a3f669039c81e5174a99bc8354fdd75b02a2e4caa3373eb4565
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Security for datanyx 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for datanyx-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page