# seedfaker

Deterministic synthetic data generator for realistic, correlated, and noisy test records across 65+ locales.
Rust CLI + Python + Node.js + Go + PHP + Ruby + MCP.

## Install

```bash
npx @opendsr/seedfaker name email -n 3         # try without installing
brew install opendsr-std/tap/seedfaker         # macOS / Linux
cargo install seedfaker                        # from source
```

Also available via [npm](https://www.npmjs.com/package/@opendsr/seedfaker), [pip](https://pypi.org/project/seedfaker/).

## Highlights

- **214 fields** — person, finance, auth, gov-id, internet, healthcare, dev, ops
- **68 locales** with native scripts (Cyrillic, CJK, Arabic, Devanagari, Thai)
- **Deterministic** — same seed = same output, byte for byte
- **Context mode** — lock name/email/phone to one identity per record (`--ctx strict`)
- **Corruption simulation** — OCR errors, truncation, mojibake (`--corrupt low|mid|high|extreme`)
- **13 presets** — nginx, auth, postgres, payment, pii-leak, stacktrace, and more
- **Formats** — CSV, TSV, JSONL, SQL, templates with conditionals and loops
- **Replace mode** — anonymize existing CSV/JSONL via stdin
- **MCP server** — Model Context Protocol for AI tool integration
- **Streaming** — unlimited output with `-n 0`, rate limiting with `--rate`

## Quick start

```bash
seedfaker name email phone --seed demo -n 5
seedfaker name email --seed demo --locale en,de --ctx strict -n 10
seedfaker run nginx -n 1000 --seed bench
echo "name,email" | seedfaker replace name email --seed anon
```

## Documentation

- [Quick start](https://github.com/opendsr-std/seedfaker/blob/main/docs/quick-start.md)
- [CLI reference](https://github.com/opendsr-std/seedfaker/blob/main/docs/cli.md)
- [Field reference (214 fields)](https://github.com/opendsr-std/seedfaker/blob/main/docs/field-reference.md)
- [Library API](https://github.com/opendsr-std/seedfaker/blob/main/docs/library.md) (Python, Node.js, Go, PHP, Ruby)
- [MCP server](https://github.com/opendsr-std/seedfaker/blob/main/docs/mcp.md)

## License

MIT
