mozaiks 0.1.7

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 brings together three things that usually live in separate tools:

• Mozaiks Studio for creating apps, continuing builds, and managing them.
• AI workflow orchestration powered by AG2 for planning, tool use, human review, and generation.
• Generated app files with modules, pages, workflows, config, and brand assets that Mozaiks validates before making active.

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 Python 3.11+ and Node.js 18+. Studio also needs a reachable MongoDB database for workspace state. Docker Desktop is not required; use MongoDB Atlas, a local MongoDB install, or Docker only if that is how you prefer to run MongoDB.

Install Mozaiks:

pip install mozaiks

Configure MongoDB before opening Studio:

# Local MongoDB
$env:MONGO_URI="mongodb://localhost:27017/mozaiks"

# Or MongoDB Atlas
$env:MONGO_URI="<your MongoDB connection string>"

Set an LLM key before running real builds:

$env:OPENAI_API_KEY="sk-..."

Then start Mozaiks:

python -m mozaiks quickstart --dir .\mozaiks-workspace

This creates .\mozaiks-workspace and starts the local Studio.

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

.\mozaiks-workspace is the local workspace folder Mozaiks uses for generated output, config, and launch scripts. It is not the app itself. The app is created later from inside Studio.

Which Tool To Use

The Studio is the browser product for creating apps, continuing builds, reviewing artifacts, and managing apps. The CLI is just how you set up the local workspace, start processes, run diagnostics, and open Studio.

studio is also the host name used internally for that same browser product. Most users can start from Studio and ignore the host details.

Want to contribute? See the Contributing guide.

Main repo layout:

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