---
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.
## Highlights
- **Realistic data** โ Jinja2 templates with [Faker](https://faker.readthedocs.io/) and [Mimesis](https://mimesis.name/) 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](https://eventum.run) for visual editing, event preview, and monitoring
- **Ready-made generators** โ connect a git repository that publishes generators and install one as a project; the repositories published on GitHub under the `eventum-generators` topic are listed in Studio
- **REST API** โ start, stop, and manage generators programmatically
- **MCP server** โ manage generators and author configurations from AI assistants via the Model Context Protocol
- **Encrypted secrets** โ credentials stored securely via an encrypted keyring
- **Docker ready** โ multi-stage builds, runs anywhere
## Quick start
**Install**
```bash
pip install eventum-generator
```
> Also available via [uv](https://docs.astral.sh/uv/) (`uv tool install eventum-generator`) or [Docker](https://hub.docker.com/r/rnv812/eventum-generator) (`docker pull rnv812/eventum-generator`).
**Create a template** โ `events.jinja`
```jinja
{{ timestamp }} INFO user={{ module.faker.locale.en.user_name() }} action=login ip={{ module.faker.locale.en.ipv4() }}
```
**Create a config** โ `generator.yml`
```yaml
input:
- cron:
expression: "* * * * * *"
count: 1
event:
template:
mode: all
templates:
- my_event:
template: events.jinja
output:
- stdout: {}
```
**Run**
```bash
eventum generate --path generator.yml --id demo
```
```
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](https://eventum.run/docs/plugins) for the full list.
## Application mode
Run multiple generators with a web UI and REST API:
```bash
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.
## Eventum Studio
**Eventum Studio** is the web UI included in application mode: edit generator configurations and templates, preview rendered events, and monitor running generators.
## Documentation
Full documentation at **[eventum.run](https://eventum.run)**:
- [Getting started](https://eventum.run/docs) โ overview and first example
- [Installation](https://eventum.run/docs/core/introduction/installation) โ pip, Docker, or from source
- [Core concepts](https://eventum.run/docs/core/concepts/generator) โ pipeline, plugins, scheduling
- [Plugin reference](https://eventum.run/docs/plugins) โ every plugin with full parameter tables
- [Tutorials](https://eventum.run/docs/tutorials) โ end-to-end walkthroughs (SIEM, clickstream, IoT, and more)
## Activity
