rnv812/eventum-generator repository overview

⁠Eventum

Data generation platform

Realistic synthetic events for testing, demos, and pipelines — streamed live or generated in bulk.

Documentation⁠  ·  Tutorials⁠  ·  API Reference⁠  ·  Changelog⁠  ·  Task tracker⁠  ·  Discuss⁠

Eventum produces synthetic events and delivers them anywhere — in real time or in batch. Generate a continuous stream of logs for your SIEM, seed a staging database with realistic data, or stress-test a pipeline with high-throughput traffic. Define everything in YAML, no code required.

⁠Highlights

• Realistic data — Jinja2 templates with Faker⁠ and Mimesis⁠ generate believable names, IPs, timestamps, and domain-specific values
• Flexible scheduling — cron expressions, fixed intervals, or statistical time patterns that mimic real-world traffic curves
• Multiple destinations — fan-out to stdout, files, ClickHouse, OpenSearch, or any HTTP endpoint simultaneously
• Two modes — stream events in real time at their scheduled timestamps, or generate everything as fast as possible
• Built-in web UI — Eventum Studio⁠ for visual editing, event preview, and monitoring
• REST API — start, stop, and manage generators programmatically
• Encrypted secrets — credentials stored securely via an encrypted keyring
• Docker ready — multi-stage builds, runs anywhere

⁠Quick start

Install

pip install eventum-generator

Create a template — events.jinja

{{ timestamp }} INFO  user={{ module.faker.locale.en.user_name() }} action=login ip={{ module.faker.locale.en.ipv4() }}

Create a config — generator.yml

input:
  - cron:
      expression: "* * * * * *"
      count: 1

event:
  template:
    mode: all
    templates:
      - my_event:
          template: events.jinja

output:
  - stdout: {}

Run

eventum generate --path generator.yml --live-mode

2026-02-23 12:00:01+00:00 INFO  user=jsmith action=login ip=192.168.44.12
2026-02-23 12:00:02+00:00 INFO  user=amiller action=login ip=10.0.128.55
2026-02-23 12:00:03+00:00 INFO  user=kwilson action=login ip=172.16.0.91

⁠Plugins

Each part of the pipeline is a plugin. Swap, combine, or extend — change the schedule without touching templates, add new outputs without modifying anything else. See the plugin reference⁠ for the full list.

⁠Application mode

Run multiple generators with a web UI and REST API:

eventum run -c eventum.yml

Starts on port 9474 with Eventum Studio (web UI), REST API, and multi-generator orchestration — each generator runs independently with its own schedule, templates, and outputs.

⁠Documentation

Full documentation at eventum.run⁠:

• Getting started⁠ — overview and first example
• Installation⁠ — pip, Docker, or from source
• Core concepts⁠ — pipeline, plugins, scheduling
• Plugin reference⁠ — every plugin with full parameter tables
• Tutorials⁠ — end-to-end walkthroughs (SIEM, clickstream, IoT, and more)

⁠Activity

⁠

⁠License

Apache License 2.0⁠