Performance

Generates millions of events on a single machine. Scales linearly with worker threads.

~0

Events / sec

single thread

~0

Events / sec

4 worker threads

<0ms

Cold start

zero config

0

Dependencies

at runtime

Live throughput

5,127 events/sec

8k 6k 4k 2k 0

-60s -40s -30s -20s now

Quick Start

Use the CLI to scaffold a project, or import the library directly.

CLI

# Install the CLI globally
npm install -g @synode/cli

# Scaffold a new project
synode init

# Generate 1,000 users from config
synode generate synode.config.ts --users 1000

# Validate config without generating
synode validate synode.config.ts

Library

import {
  defineAction,
  defineAdventure,
  defineJourney,
} from '@synode/core';

const viewProducts = defineAction({
  id: 'view',
  name: 'page_view',
  wait: '10s',
  fields: {
    url: '/products',
    referrer: (ctx) => ctx.faker.internet.url(),
  },
});

const productList = defineAdventure({
  id: 'product-list',
  name: 'Product List',
  wait: '2m',
  actions: [viewProducts],
});

const browse = defineJourney({
  id: 'browse',
  name: 'Browse Products',
  weight: 5,
  cooloff: '30m',
  adventures: [productList],
});

import { generate, FileAdapter } from '@synode/core';

await generate([browse, purchase], {
  time: {
    start: new Date('2026-01-01'),
    duration: '90d',
  },
  simulation: {
    users: 500,
    lanes: 8,
    tick: '15m',
    scatter: 0.15,
  },
  adapter: new FileAdapter({ dir: './output' }),
});
// → Simulated 90 days of activity across 500 users

Reverse Engineering

Already have event data?

Drop a CSV, JSONL, or JSON export and Synode builds your entire config automatically. Journeys, field distributions, datasets, and personas. All detected from your data.

GA4 Segment Mixpanel CSV Custom

 $ synode analyze

Learn more →

incoming events

page_view /home

click cta

page_view /products

add_to_cart SKU-42

page_view /checkout

purchase $149

page_view /home

search chairs

view_item SKU-17

add_to_cart SKU-17

page_view /home

click cta

page_view /products

add_to_cart SKU-42

page_view /checkout

purchase $149

detected config

Browse → Cart → Purchase

Journey · weight: 0.72 · bounce: 15%

page_view.url

weighted({'/home': 0.5, '/products': 0.3})

Products

Dataset · 42 items · 5 fields

Persona

locale, device, country distributions

Features

Everything you need to generate realistic synthetic data for your platform.

Journey Hierarchy

Four levels deep. Journey, Adventure, Action, Event. Each with timing, bounce rates, and suppression periods.

Personas & Datasets

Weighted attribute distributions and typed datasets with compile-time safety.

Simulation Engine

Tick-based clock advances time in configurable steps. Lanes act as concurrent user slots. Cooloffs, weights, and scatter produce realistic activity patterns across a time window.