Muxi

MUXI V1: Deploy Intelligence

MUXI (/ˈmʌk.siː/) is the AI application server. Not a framework. Not a wrapper. A complete, self-hosted server stack where agents are native primitives and production capabilities are infrastructure, not application code.

Deploy complete agent formations with orchestration, auditable memory, group-based RBAC, tools, knowledge, proactive behavior, self-tuning, observability, and twelve SDKs already integrated.

[!IMPORTANT] MUXI V1 is the stable 1.x generation. The Server, Runtime, CLI, Formation API, Server API, and all twelve SDKs move together with coordinated contracts for authentication, streaming, errors, idempotency, and response envelopes.

[!NOTE] MUXI introduced the Agent Formation Standard – an open specification for portable, declarative AI systems. A formation packages agents, knowledge, memory, tools, skills, workflows, triggers, policies, and operational behavior into one deployable unit.

Quick Start

Install:

brew install muxi-ai/tap/muxi                        # macOS
curl -fsSL https://muxi.org/install | sudo bash      # Linux
powershell -c "irm https://muxi.org/install | iex"   # Windows

Run:

muxi pull @muxi/hello-muxi   # pull a formation
muxi deploy                   # deploy it
muxi chat hello-muxi         # talk to it

Three commands. Your formation is running, stateful, and accessible through REST, SSE, MCP, and twelve SDKs.

📚 Docs: Quickstart | Installation

Build on Top with SDKs

from muxi import FormationClient

client = FormationClient(
    server_url="http://localhost:7890",
    formation_id="hello-muxi",
    client_key="<your-client-key>"
)

for chunk in client.chat_stream({ "message": "Hello!" }, user_id="user_123"):
    print(chunk.get("text", ""), end="")

Official SDKs are available for Python, TypeScript, Go, Ruby, PHP, C#, Java, Kotlin, Swift, Dart, Rust, and C++.

📚 Docs: SDKs | API Reference

How MUXI Compares

MUXI is the infrastructure layer. Frameworks help write agent logic. MUXI deploys and operates complete agent systems.

What Ships with MUXI V1

Systems that learn, remember, and act

• Formation self-tuning – operational evidence becomes reviewable revisions of MUXI.md, backed by experiments and watched metrics. You decide what gets applied. Docs
• Living, auditable memory – layered context plus user/group/formation scopes, immutable events, provenance, rebuilds, selective forgetting, decay, knowledge graphs, Captain's Logs, lessons, and signed on-premises distillation. Docs
• Proactive formations – heartbeats, active hours, per-user channels, SOUL.md, notification routing, and built-in slash commands let formations initiate useful work instead of waiting for prompts. Docs
• Reasoning RAG – navigate hierarchical document trees, combine tree and vector retrieval, and synchronize remote knowledge from cloud storage, HTTP, rsync, FTP, and SFTP. Docs

Enterprise control without a separate platform

• Group-based RBAC – inheritance plus agent, MCP-server, and individual-tool allow/deny rules, with fail-closed external membership resolution. Docs
• Multi-tenant isolation – sessions, memory, artifacts, and encrypted credentials stay scoped to the user while one formation serves an entire product or organization. Docs
• Persistent artifact memory – generated documents, spreadsheets, presentations, charts, and code are versioned, encrypted, user-scoped, and recallable across sessions. Docs
• Production resilience – circuit breakers, fallback models, exponential backoff, graceful degradation, and idempotency keys make retries safe without duplicating work. Docs
• Built-in observability – hundreds of typed lifecycle events trace models, tools, memory, workflows, and triggers, with secret and entity-based PII redaction before export. Docs

Agents that connect to everything

• MCP in both directions – connect large tool catalogs without injecting every schema into every prompt, and expose any formation as an MCP server to Claude Desktop, Cursor, or another MCP client. Docs
• Coding-agent delegation – hand repository work to Claude Code, Droid, OpenCode, Pi, or a custom headless adapter in isolated asynchronous workspaces. Docs
• Zero-token job monitoring – deterministic polling tracks long-running MCP work without spending LLM tokens asking whether it finished. Docs
• Generative UI – streamed and non-streamed responses can carry typed options, action links, and MCP resources that all twelve SDKs expose idiomatically. Docs
• Triggers and outbound routing – schedules, webhooks, and external events activate formations, then transformers deliver results to Slack, Telegram, Discord, email, or custom destinations. Docs

Agent-native execution

• Intelligent orchestration – the Overlord routes requests, matches SOPs, decomposes complex work, coordinates agents, and can replan workflows when intermediate results change the best path. Docs
• Skills and sandboxed compute – use open SKILL.md packages with progressive disclosure and execute scripts in an isolated RCE sandbox with resource and timeout controls. Docs
• Hierarchical model selection – choose cloud, local, or OpenAI-compatible models at the formation, agent, SOP, trigger, skill, or workflow-step level, with aliases and fallback chains. Docs
• A2A collaboration – delegate work across formations and external agent services with API-key, OAuth 2.0, HMAC, and OpenID authentication. Docs
• Multimodal by default – process images, PDFs, audio, video, Office documents, and structured data through the same formation runtime. Docs

Example Formation

# formation.afs -- define your AI system (it's just YAML)
schema: "1.0.0"
id: "customer-support"
description: Helps customers with product support and refunds

llm:
  models:
    - text: "openai/gpt-4o"
  api_keys:
    openai: "${{ secrets.OPENAI_API_KEY }}"

agents:
  - sales-assistant

# agents/sales-assistant.afs -- define an agent
schema: "1.0.0"
id: sales-assistant
name: Sales Assistant
description: Helps customers with product questions

system_message: Help customers find products and answer questions.

knowledge:
  sources:
    - path: knowledge/product-info.docx
    - path: knowledge/shipping-rates.csv

muxi deploy   # that's it -- running, stateful, API-accessible

📚 Docs: Formation Schema | Examples

Who Is MUXI For?

• Platform builders – Building a SaaS with AI features? MUXI handles orchestration, memory, and multi-tenancy so you can focus on your product.

• Internal tool builders – Deploying AI systems across an organization? MUXI gives you group-based RBAC, scoped memory, per-user credentials, SOPs, observability, and self-tuning out of the box.

• Developers tired of framework hell – Spent months on LangChain orchestration code? MUXI replaces it with YAML configuration and a single deploy command.

Open Source & Self-Hosted

MUXI is open-source and self-hostable. Your data stays on your infrastructure. No vendor lock-in. No per-seat pricing. No usage limits.

• Self-hostable – run anywhere, owned by you
• Access-controlled – fail-closed group RBAC down to individual tools
• Observable – see what's happening, always
• Declarative – version-controlled and reproducible
• Open – no lock-in, no surprises

Documentation

Agent Skills

This repo includes an Agent Skill that gives any compatible AI agent (Claude Code, Cursor, GitHub Copilot, VS Code, etc.) deep knowledge of the MUXI platform.

See skills/ for setup instructions.

Get Involved

• Star this repo to follow progress
• Discussions – ask questions, share ideas, get help
• Roadmap – see what's coming
• @muxi_ai – follow for updates
• CONTRIBUTING.md – contribute code

Who's Behind This

MUXI is created by Ran Aroussi, author of Production-Grade Agentic AI (665 pages) and an open-source developer whose tools are used by millions of developers daily.

[!IMPORTANT] MUXI is built on the principles from Production-Grade Agentic AI – a comprehensive guide to building enterprise AI agent systems in production. Download the PDF version here ›.

License

Server and Runtime are ELv2. Everything else (CLI, SDKs, formations, schemas) is Apache 2.0.

TL;DR: Use MUXI freely for your products and business. The only restriction: don't resell MUXI itself as a hosted service. See LICENSE.md for details.