Mozaiks¶

Note: This is the unified Mozaiks stack. BlocUnited offers a managed platform with app generation tools at mozaiks.ai, but you're welcome to self-host and build everything yourself.

Start Here: New to Mozaiks? Start with the Getting Started guide, then use Install Modes if you need to choose between the builder path and the lower-level framework path.

Maintainers: Use Releasing for the tag-driven package publish flow.

🎯 What is mozaiksai?¶

mozaiksai Runtime is a production-ready orchestration engine that transforms AG2 (Microsoft Autogen) into an app-grade platform with:

• ✅ Event-Driven Architecture -> Runtime, app, workflow, UI, and hosted events stay separated by contract
• ✅ Real-Time WebSocket Transport -> Live streaming to React frontends
• ✅ Persistent State Management -> Resume conversations exactly where they left off
• ✅ Multi-Tenant Isolation -> app-scoped data and execution contexts
• ✅ Dynamic UI Integration -> Agents can invoke React components during workflows
• ✅ Declarative Workflows -> JSON manifests, no code changes needed
• ✅ Mid-Flight Journeys (MFJ) -> Workflow-local fork/join with deterministic parent resume beyond base AG2 handoffs
• ✅ Comprehensive Observability -> Built-in metrics, logging, and token tracking

mozaiksai = AG2 + Production Infrastructure + Layered Event Contracts

🎨 See It In Action¶

💬 Embeddable Floating Widget¶

Drop a floating assistant anywhere in your app - click the button to expand/collapse the chat interface

---

🔀 Dual-Mode Interface¶

Workflow Mode	Ask Mode
Chat + Artifact split view	Full chat with history sidebar

Start Here¶

Choose the path that matches what you need to do.