# seedfaker

Deterministic synthetic data generator. 200+ fields, 68 locales.

**CLI** · [Node.js](https://www.npmjs.com/package/@opendsr/seedfaker) · [Python](https://pypi.org/project/seedfaker/) · [Browser/WASM](https://www.npmjs.com/package/@opendsr/seedfaker-wasm) · [Go](https://github.com/opendsr-std/seedfaker-go) · [PHP](https://packagist.org/packages/opendsr/seedfaker) · [Ruby](https://rubygems.org/gems/seedfaker) · [MCP](https://github.com/opendsr-std/seedfaker/blob/main/docs/mcp.md)

## Install

```bash
brew install opendsr-std/tap/seedfaker         # macOS / Linux
cargo install seedfaker                        # from source
npm install -g @opendsr/seedfaker-cli          # npm
```

> **Pre-1.0:** API may change. Pin your version.
- **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 (200+ 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
