git404hub

what is ocel-generator fr?

juliensimon/ocel-generator — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

ocelgen generates realistic synthetic multi-agent AI workflow traces, complete with LLM prompts, tool calls, and labeled deviations, for testing and benchmarking observability tools.

vibe map

mindmap
  root((ocelgen))
    What it does
      Synthetic agent traces
      LLM enrichment
      Deviation injection
      OCEL 2.0 validation
    Tech stack
      Python
      OCEL 2.0
      PM4Py
      Hugging Face
    Use cases
      Observability testing
      Anomaly detection training
      Agent framework benchmarking
    Audience
      ML researchers
      Agent framework developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Generate realistic agent trace data to test an observability dashboard without running real AI workloads.

VIBE 2

Train an anomaly detector on labeled conformant versus deviant multi-agent traces.

VIBE 3

Benchmark agent frameworks like LangGraph, CrewAI, or AutoGen against standardized synthetic scenarios.

VIBE 4

Download a pre-built dataset of 17,000+ events from Hugging Face instead of generating your own.

what's the stack?

PythonOCEL 2.0PM4PyHugging Face

how it stacks up fr

juliensimon/ocel-generator920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/53/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Structural trace generation needs no API key, enrichment with real LLM content requires an OpenAI-compatible API key or local model.

MIT licensed, free to use, modify, and redistribute including in commercial projects.

in plain english

ocelgen is a tool for generating realistic synthetic workflow traces from multi-agent AI systems. A trace here is a detailed log of everything that happened during a task: which AI agents were involved, what prompts they received, what responses the language model returned, which tools were called, how long each step took, and what it cost. These traces mirror the observability data you would capture from a real production AI system. The tool is designed for teams who need trace data for testing, training, or benchmarking without running actual AI workloads at scale. It can produce over 1,500 events in under two seconds with no API key required. When you connect an AI model through an OpenAI-compatible endpoint, it fills each trace with realistic generated content, including actual LLM prompts and responses, tuned to the chosen scenario. Three workflow structures are supported: sequential, where one agent hands off to the next, supervisor, where one coordinator delegates to multiple workers, and parallel, where multiple workers run at the same time. Traces can also include intentional deviations such as wrong tool calls, skipped steps, and timeouts, each with ground-truth labels, which makes the data useful for training anomaly detection systems. Ten deviation types are available in total. Ten built-in domains are included, covering scenarios like customer support triage, code review, incident response, and financial analysis. Custom domains can be defined in a YAML configuration file and merged with the built-in set. Every generated trace passes through five validation layers checking things like schema compliance and temporal ordering, and follows the OCEL 2.0 standard so it loads directly into PM4Py, a process mining library. A pre-built dataset of over 17,000 events is also available on Hugging Face for teams who prefer not to generate their own. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Show me how to install ocelgen and generate a sequential workflow trace with the customer-support-triage domain.
prompt 2
How do I enrich generated traces with real LLM content using a local model via Ollama or vLLM?
prompt 3
Write a YAML config for a custom ocelgen domain that simulates an HR onboarding workflow.
prompt 4
Explain how to load an ocelgen-generated OCEL 2.0 trace file into PM4Py for conformance checking.

Frequently asked questions

what is ocel-generator fr?

ocelgen generates realistic synthetic multi-agent AI workflow traces, complete with LLM prompts, tool calls, and labeled deviations, for testing and benchmarking observability tools.

What language is ocel-generator written in?

Mainly Python. The stack also includes Python, OCEL 2.0, PM4Py.

What license does ocel-generator use?

MIT licensed, free to use, modify, and redistribute including in commercial projects.

How hard is ocel-generator to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ocel-generator for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.