Skip to the content.

Architecture & Design Concepts

OpenMimic is designed around a schema-first, deterministic generation engine communicating over gRPC with modern visual and AI interfaces.


🏛️ High-Level System Architecture

                    ┌───────────────────────────┐
                    │       Mimic Studio        │
                    │  (React 18 + Mantine UI)  │
                    └─────────────┬─────────────┘
                                  │
                  ┌───────────────┴───────────────┐
                  │                               │
       HTTP /api/*│                               │ HTTP /generate-config
                  ▼                               ▼
       ┌─────────────────────┐         ┌─────────────────────┐
       │   OpenMimic Engine  │         │    Mimic Copilot    │
       │   (Go 1.23+ Core)   │         │ (FastAPI/LangChain) │
       │  gRPC :50051 + HTTP │         │      Port: 8000     │
       └──────────┬──────────┘         └──────────┬──────────┘
                  │                               │
                  │ Validated by                  │ Validated by
                  ▼                               ▼
       ┌─────────────────────────────────────────────────────┐
       │              proto/mimic_config.proto               │
       │           (Single Source of Truth)                  │
       └─────────────────────────────────────────────────────┘
                  │
        Streaming Sinks
                  ├── Kafka (:9092)
                  ├── PostgreSQL (pgx)
                  ├── Amazon S3
                  └── Stdout (JSON stream)

🔑 Core Architecture Pillars

1. Single Source of Truth (proto3)

All configuration models, sink destinations, function generators, and service RPCs originate in proto/mimic_config.proto.

2. Deterministic State Engine

Replayability and test verification require that the exact same stream can be reproduced across multiple runs or distributed workers:

3. High-Throughput Sinks

The engine supports hot-swappable streaming sinks implementing the Sink interface:

4. Zero-Overhead Observability

The internal metrics collector records: