OpenMimic Documentation
Welcome to OpenMimic, the 100% free and open-source, visual-first synthetic data and production traffic generation platform.
OpenMimic allows engineers, architects, and data teams to generate realistic, mathematically sound data streams directly into Kafka, PostgreSQL, S3, or stdout without relying on static mock files or fragile bash scripts.
☕ Support Open-Source & Buy Us a Coffee
OpenMimic is maintained as an open-source community effort under the Apache 2.0 license.
If OpenMimic helps your engineering workflows:
⚡ Quick Navigation
- Local Setup & Quickstart Guide — Launch with Docker Compose or from source.
- Enterprise Single Sign-On (SSO) & RBAC Guide — Okta, Microsoft Entra ID, Keycloak, OIDC, and group role mappings.
- Model Context Protocol (MCP) Server Guide — Autonomous LLM agent tool integration (Claude, Cursor, Docker).
- Traffic Simulation & Load Generation Guide — Production traffic shaping, diurnal curves, Poisson arrivals, and Markov funnels.
- Functions & Expression Reference — Complete guide to
uuid,normalDistribution,weightedChoice,markovChain, etc. - Configuration Reference (
mimic.json) — Full Protocol Buffers schema guide. - Mimic Studio Manual — Designing schemas, live previews, and observability dashboards.
- Mimic Copilot Manual — Natural-language data synthesis.
- Architecture & Design Concepts — Engine internals, logical clock, and sinks.
🚀 Why OpenMimic?
| Feature | OpenMimic | Commercial Data Generators | Static Mock Scripts |
|---|---|---|---|
| License | 100% Free Apache 2.0 | Proprietary / Closed ($15k+/yr) | In-house |
| Visual Studio UI | ✓ Built-in React 18 UI | ✕ None (JSON Only) | ✕ None |
| AI Copilot | ✓ Natural Language to Proto3 | ✕ None | ✕ None |
| Observability | ✓ Live Throughput, p99, Errors | Limited CLI metrics | Manual logging |
| Traffic Shaping | ✓ Diurnal, Poisson, Flash Bursts | Basic rate limit | Fixed sleeps |
| Relational Entity Pools | ✓ Shared Pools & Markov Funnels | State tracking | Complex custom code |
| SQL DDL Import | ✓ One-Click CREATE TABLE parser |
✕ None | ✕ None |
| Universal Sinks | ✓ Kafka, Postgres, S3, Iceberg, Delta | Kafka, Postgres, S3 | Single-target |