Repolode
Submit
eventum-generator

eventum-generator/eventum

Data generation platform that produces realistic synthetic events and streams them live or generates them in bulk to logs, databases, and HTTP endpoints.

View on GitHubWebsite
Stars
70
Forks
4
Open issues
10
Last commit
2 days ago

What is it?

Eventum generates synthetic events for testing, demos, and data pipelines. Event templates are written in Jinja2 and can use Faker and Mimesis to produce believable names, IP addresses, timestamps, and domain-specific values. Scheduling supports cron expressions, fixed intervals, and statistical time patterns that imitate real traffic curves.

Each generator runs a pipeline of input, event, and output plugins. Output can fan out to stdout, files, ClickHouse, OpenSearch, or any HTTP endpoint at the same time. The tool runs in two modes: real-time streaming at scheduled timestamps, or as-fast-as-possible bulk generation. It is distributed on PyPI and Docker Hub, and runs on Linux.

In application mode, the eventum run command starts a web UI called Eventum Studio, a REST API, and orchestration for multiple generators. An MCP server lets AI assistants manage generators and author configurations, and credentials are stored in an encrypted keyring.

Key features

  • 01Jinja2 templates with Faker and Mimesis for realistic values
  • 02Cron, fixed-interval, and statistical time-based scheduling
  • 03Output to stdout, files, ClickHouse, OpenSearch, or HTTP endpoints
  • 04Real-time streaming or bulk generation modes
  • 05Web UI, REST API, and MCP server for managing generators
  • 06Encrypted keyring for storing credentials

Use cases

  • Generating a continuous log stream to test a SIEM or observability pipeline
  • Seeding a staging database with realistic synthetic records
  • Stress-testing an ingestion pipeline with high-throughput traffic
  • Producing demo data for dashboards and presentations

Quick start

  1. 1

    Install the package with pip

    pip install eventum-generator
  2. 2

    Create a template file events.jinja (file content, not a command)

  3. 3

    Create a config file generator.yml (file content, not a command)

  4. 4

    Run the generator

    eventum generate --path generator.yml --id demo

Things to know

  • The README lists Linux and Docker as supported platforms.
  • Application mode and Studio require running a separate server process.

Topics

#synthetic-data#test-data#log-generator#fake-data#load-testing#observability#clickhouse#data-engineering#data-generation#devops

FAQ

What is eventum?
Data generation platform that produces realistic synthetic events and streams them live or generates them in bulk to logs, databases, and HTTP endpoints. Eventum generates synthetic events for testing, demos, and data pipelines. Event templates are written in Jinja2 and can use Faker and Mimesis to produce believable names, IP addresses, timestamps, and domain-specific values. Scheduling supports cron expressions, fixed intervals, and statistical time patterns that imitate real traffic curves.
Is eventum free to use? What license does it have?
eventum is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is eventum still maintained?
Actively maintained. The last commit to eventum was on Oct 18, 2026.
What can I use eventum for?
Generating a continuous log stream to test a SIEM or observability pipeline Seeding a staging database with realistic synthetic records Stress-testing an ingestion pipeline with high-throughput traffic Producing demo data for dashboards and presentations
How do I install eventum?
Install the package with pip: pip install eventum-generator Create a template file events.jinja (file content, not a command) Create a config file generator.yml (file content, not a command) Run the generator: eventum generate --path generator.yml --id demo
Where can I get eventum?
The source code and installation instructions are on GitHub: https://github.com/eventum-generator/eventum

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects