Skip to content
Agent-Friendly CLI for Fake Data

Generate
Anything Fake

Generate names, emails, addresses, dates, numbers, images, and more — all from your terminal.

terminal
$ faker person.fullName --seed 42
"Mohammad Crist"
$ faker internet.email --locale de
"Alia.Hargasser99@yahoo.com"
$ faker --schema '{"name":"person.fullName","email":"internet.email"}'
{"name":"Heather Padberg","email":"Heather_Padberg@yahoo.com"}
$
Why faker-cli

Built for machines.
Readable by humans.

{ }

Pure JSON Output

Every command outputs valid JSON to stdout. Errors to stderr. No parsing needed — pipe directly into jq, your agent, or any automation.

--schema

Schema Mode

Define the shape you need as a JSON template. faker-cli resolves every field to realistic data. Nested objects, arrays, inline args — all supported.

--describe

Self-Discoverable

Agents don't need docs. Every module and method is introspectable with --describe. Parameters, types, return values, and CLI examples — all built in.

--seed 42

Deterministic

Same seed, same output. Every time. Combine with --locale for 60+ languages and --ref-date to pin dates. Fully reproducible test data.

Get Started in Seconds

Install with Homebrew

$brew install zcaceres/tap/faker-cli
or download binaries for
macOSLinuxWindows