mozaiks 0.1.2

Mozaiks AG2 runtime and Studio-driven app framework

Mozaiks

What is Mozaiks?

Mozaiks is an open-source AI app factory for building, running, and iterating on AI-native software products.

It combines three pieces that usually live in separate tools:

• Mozaiks Console for creating apps, reviewing builds, and managing app workspaces.
• AG2 workflow orchestration for multi-agent planning, tool use, human review, and mid-flight decomposition.
• A generated app workspace contract with modules, pages, workflows, config, and brand assets that can be validated before promotion.

The goal is not to generate a throwaway demo. Mozaiks stages production-shaped artifacts, validates them against strict contracts, and keeps runtime concerns separate from builder workflows.

Quickstart

Install Mozaiks and open the Console:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install mozaiks
mozaiks quickstart --dir .\mozaiks-workspace

Then open http://localhost:3000/apps and click Create App.

.\mozaiks-workspace is the local workspace Mozaiks uses for Console state and generated artifacts. The app itself is created from the Console.

Use an editable repo checkout only when developing Mozaiks itself:

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

Framework commands:

• mozaiks init
• mozaiks studio --dir <workspace> --open
• mozaiks sync-agent-guidance --dir . --check
• mozaiks onboard --full
• mozaiks serve

Main repo layout:

• web_shell/ - local Vite shell host source
• factory_app/app/ - first-party Console 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.