Phony Cloud Platform

"Realistic data. Zero risk."

Phony is the next-generation synthetic data platform combining open-source developer tools with enterprise-grade cloud services.

---

Quick Start

Get up and running with Phony in under 5 minutes.

Step 1: Install the CLI

# macOS / Linux
curl -fsSL https://phony.cloud/install.sh | sh

# Windows (PowerShell)
irm https://phony.cloud/install.ps1 | iex

# Verify installation
phony --version

Step 2: Train Your First Model

Create a file with sample names (one per line):

# Create sample data
cat > names.txt << 'EOF'
Mehmet
Ayşe
Fatma
Ahmet
Zeynep
Mustafa
Elif
Ali
Hatice
Hüseyin
EOF

# Train the model
phony train names.txt -o names.ngram

# Inspect the model
phony info names.ngram

Output:

Model: names.ngram
├── Token type    : Char
├── N-gram order  : 3
├── Trained items : 10
├── N-grams       : 45
└── File size     : 548 bytes

Step 3: Generate Data

The same CLI generates values — locally, offline, and deterministically:

# A built-in generator, by name
phony generate --use @phony/core:logic.uuid_v7 -n 5 --seed 42

# An inline PGDL definition (any core generator)
echo '{ "type": "statistical", "mode": "continuous", "distribution": "normal", "params": { "mean": 35, "stddev": 10 } }' > age.json
phony generate age.json -n 1000 --seed 7 -f jsonl

# A package's compositions + model assets
phony generate --package ./my-package --use @acme/demo:name -n 20 --seed 5

The same seed produces byte-identical output on every run and every machine.

Step 4: Use from your language (planned)

Language libraries are not built yet — PHP is planned first, followed by JS/Python bindings. They will read the same portable .ngram models the CLI trains, so a Laravel factory like this is the target design:

// Target design — phonycloud/phony-php + phony-laravel (planned)
use Phonyland\Phony\Facades\Phony;

public function definition(): array
{
    return [
        'first_name' => Phony::name()->first(),
        'email'      => Phony::email()->generate(),
    ];
}

Next Steps

Goal	Resource
Understand generator types	Architecture → Generator Types
Learn PGDL schema language	Architecture → PGDL Specification
Explore CLI commands	Reference → CLI
Connect to Cloud	Product → Overview

---

What You Get: OSS vs Cloud

Capability	OSS (Free)	Cloud (Paid)
Pre-trained models	✓	✓
Local model training	✓	✓
Model portability (.ngram)	✓	✓
Unlimited local generation	✓	✓
DB column training	✗	✓
Database sync & anonymization	✗	✓
Data snapshots	✗	✓
Mock API hosting	✗	✓
Team collaboration	✗	✓

Open source is free forever for individual developers. Cloud adds the infrastructure features teams need.

Going deeper? The Product Overview covers the platform vision, architecture, and use cases. For the data engine, see the core generators (five core types + composition) and the PGDL specification. Pricing is on the Pricing page.