Metadata-Version: 2.4
Name: muxi-runtime
Version: 0.20260313.1
Summary: Production-ready runtime for building and orchestrating intelligent multi-agent AI systems
Home-page: https://muxi.org
Author: MUXI Team
Author-email: MUXI Team <dev@muxi.org>
License: Elastic License 2.0
Project-URL: Homepage, https://muxi.org
Project-URL: Documentation, https://muxi.org/docs
Project-URL: Source Code, https://github.com/muxi-ai/runtime
Project-URL: Bug Tracker, https://github.com/muxi-ai/runtime/issues
Project-URL: Discussions, https://muxi.org/community
Project-URL: Changelog, https://github.com/muxi-ai/runtime/blob/main/CHANGELOG.md
Project-URL: Funding, https://github.com/sponsors/muxi-ai
Project-URL: Download, https://pypi.org/project/muxi/
Keywords: ai,agents,llm,multi-agent,orchestration,mcp,onellm,formation,runtime,framework,chatgpt,openai,anthropic,agent-framework,ai-agents,agent-orchestration,llm-framework,ai-system
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Framework :: AsyncIO
Classifier: Framework :: FastAPI
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tomli>=1.2.0; python_version < "3.11"
Requires-Dist: orjson>=3.9.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: anyio>=3.7.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: websockets>=11.0.3
Requires-Dist: httpx-sse>=0.4.0
Requires-Dist: rich>=13.6.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: psutil>=5.9.0
Requires-Dist: mcp>=1.23.0
Requires-Dist: fastmcp>=3.0.0
Requires-Dist: aiofiles>=23.2.0
Requires-Dist: python-magic>=0.4.27
Requires-Dist: markitdown[all]>=0.1.0
Requires-Dist: pypdf>=5.0.0
Requires-Dist: python-docx>=1.1.0
Requires-Dist: markdownify>=0.11.6
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: nltk>=3.8.0
Requires-Dist: spacy>=3.8.0
Requires-Dist: sentence-transformers>=2.2.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: pdf2image>=1.16.0
Requires-Dist: onellm[cache]>=0.20260130.0
Requires-Dist: boto3>=1.26.0
Requires-Dist: google-cloud-aiplatform>=1.25.0
Requires-Dist: a2a-sdk>=0.3
Requires-Dist: fastapi>=0.108.0
Requires-Dist: uvicorn>=0.24.0
Requires-Dist: starlette>=0.49.1
Requires-Dist: faiss-cpu>=1.10.0
Requires-Dist: faissx>=0.0.3
Requires-Dist: pgvector>=0.3.6
Requires-Dist: numpy>=1.24.0
Requires-Dist: sqlite-vec>=0.1.6
Requires-Dist: psycopg2-binary>=2.9.9
Requires-Dist: SQLAlchemy[asyncio]>=2.0.17
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: aiohttp>=3.13.3
Requires-Dist: click>=8.1.0
Requires-Dist: openai>=1.3.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: scipy>=1.10.0
Requires-Dist: statsmodels>=0.14.0
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: seaborn>=0.12.0
Requires-Dist: plotly>=5.15.0
Requires-Dist: bokeh>=3.8.2
Requires-Dist: altair>=5.0.0
Requires-Dist: reportlab>=4.0.0
Requires-Dist: fpdf2>=2.7.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: xlsxwriter>=3.1.0
Requires-Dist: xlrd>=2.0.0
Requires-Dist: xlwt>=1.3.0
Requires-Dist: qrcode>=7.4.0
Requires-Dist: python-barcode>=0.15.0
Requires-Dist: python-pptx>=0.6.21
Requires-Dist: lxml>=4.9.0
Requires-Dist: cachetools>=5.3.0
Requires-Dist: croniter>=1.3.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: msgpack>=1.0.0
Requires-Dist: multitasking>=0.0.11
Requires-Dist: nanoid>=2.0.0
Requires-Dist: pytz>=2023.3
Requires-Dist: requests>=2.31.0
Requires-Dist: typing-extensions>=4.8.0
Requires-Dist: pyzmq>=25.0.0
Provides-Extra: kafka
Requires-Dist: kafka-python>=2.0.0; extra == "kafka"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: pyright>=1.1.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# MUXI Runtime

[![License](https://img.shields.io/badge/License-Elastic%202.0-blue.svg)](LICENSE)  [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

The execution engine for AI agent formations.

> **For most users:** Install [MUXI CLI](https://github.com/muxi-ai/cli) for the complete experience.
> This repo is for contributors and developers embedding the runtime directly.

> [!IMPORTANT]
> ## MUXI Ecosystem
>
> This repository is part of the larger MUXI ecosystem.
>
> **📋 Complete architectural overview:** See [muxi/ARCHITECTURE.md](https://github.com/muxi-ai/muxi/blob/main/ARCHITECTURE.md) - explains how core repositories fit together, dependencies, status, and roadmap.

## What is MUXI Runtime?

MUXI Runtime transforms declarative YAML configurations into running AI systems. It's the core engine that powers the [MUXI Server](https://github.com/muxi-ai/server).

**Core responsibilities:**
- Formation execution - Loads and runs agent configurations from YAML
- Overlord orchestration - Routes requests, manages clarifications, coordinates workflows
- Memory systems - Three-tier memory (buffer, persistent, vector)
- Tool integration - MCP protocol support for external tools
- Multi-tenant isolation - User and session management

## Architecture

```
┌─────────────────────────────────────────────────────┐
│     MUXI Server - Formation lifecycle management    │
└─────────────────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────┐
│           MUXI Runtime ◄── THIS REPO                │
│  ┌───────────────────────────────────────────────┐  │
│  │  Formation Engine (YAML loader & validator)   │  │
│  ├───────────────────────────────────────────────┤  │
│  │  Overlord │ Agents │ Workflow │ Background    │  │
│  ├───────────────────────────────────────────────┤  │
│  │  Memory │ MCP │ A2A │ LLM │ Observability     │  │
│  └───────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────┐
│   External Services (LLM APIs, MCP Servers, DBs)    │
└─────────────────────────────────────────────────────┘
```

## Package Structure

The runtime uses `src/muxi/runtime/` to share the `muxi` namespace with the [Python SDK](https://github.com/muxi-ai/sdks):

```
src/muxi/runtime/
├── formation/          # Formation engine
│   ├── overlord/       # Central orchestration
│   ├── agents/         # Agent implementations
│   ├── workflow/       # Task decomposition, SOPs
│   ├── server/         # Formation API (FastAPI)
│   └── background/     # Webhooks, scheduling, async
├── services/           # Runtime services
│   ├── memory/         # Memory systems
│   ├── mcp/            # MCP client
│   ├── a2a/            # Agent-to-agent
│   └── llm/            # LLM abstraction
└── datatypes/          # Type definitions
```

## Quick Start

### Using with MUXI Server (recommended)

```bash
# Install MUXI CLI
curl -fsSL https://muxi.ai/install | sh

# Create and run a formation
muxi new my-assistant
cd my-assistant
muxi dev
```

### Embedding directly

```bash
pip install muxi-runtime
```

```python
from muxi.runtime import Formation
import asyncio

async def main():
    formation = Formation()
    await formation.load("formation.afs")
    overlord = await formation.start_overlord()

    response = await overlord.chat(
        "Hello!",
        user_id="user123"
    )
    print(response)

asyncio.run(main())
```

## Development

```bash
git clone https://github.com/muxi-ai/runtime
cd runtime
pip install -e ".[dev]"

# Run tests
pytest tests/unit -v
pytest tests/integration -v
pytest e2e/tests -v
```

See [contributing/README.md](contributing/README.md) for contributor documentation.

## Related Repositories

| Repo | Description |
|------|-------------|
| [muxi-ai/muxi](https://github.com/muxi-ai/muxi) | Main repo with architecture docs |
| [muxi-ai/server](https://github.com/muxi-ai/server) | Go server that hosts this runtime |
| [muxi-ai/cli](https://github.com/muxi-ai/cli) | Command-line tool |
| [muxi-ai/sdks](https://github.com/muxi-ai/sdks) | Python, TypeScript, Go SDKs |
| [muxi-ai/schemas](https://github.com/muxi-ai/schemas) | API schemas |

## Documentation

- **User docs:** [docs.muxi.ai](https://docs.muxi.ai)
- **Contributor docs:** [contributing/README.md](contributing/README.md)
- **Formation spec:** [agentformation.org](https://agentformation.org)

## License

[Elastic License 2.0](LICENSE) - Free to use, modify, and embed in products. Cannot be offered as a hosted service.
