mozaiks 0.1.0

Mozaiks AG2 runtime and Studio-driven app framework

Mozaiks

🎯 What is MozaiksAI?

Declarative orchestration runtime and Studio-driven app framework for AG2 (formerly Microsoft Autogen):

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

Current recommended setup: clone the repo, create a virtual environment, run the builder bootstrap script, and let it open Studio for you.

Builder path:

git clone https://github.com/BlocUnited-LLC/mozaiks.git
cd mozaiks
.\scripts\bootstrap-builder.ps1 -Workspace .\my-first-mozaiks-app

Advanced/framework path:

• mozaiks onboard --full
• mozaiks studio --open
• mozaiks init
• mozaiks serve

Manual equivalent of the bootstrap path:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .
mozaiks quickstart --dir ./my-first-mozaiks-app

Current repo layout:

• web_shell/ - local Vite shell host source
• factory_app/app/ - shared Studio app bundle and default brand assets
• factory_app/workflows/ - shared builder workflow root

---

🎨 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

---

📚 Documentation

• Architecture Overview — System design and component model
• Getting Started — Full setup guide
• Releasing — Tag-driven release and PyPI publish flow
• Mid-Flight Journeys — Flagship orchestration capability and runtime semantics
• Workflow Authoring Contracts — Canonical strict YAML contract
• Contributing — Development workflow

Build the docs locally with pip install -r requirements-docs.txt and ./scripts/build-docs.ps1.

---

Contributing

See CONTRIBUTING.md.

License

MIT. See LICENSE.