MUXI Server

Open-source infrastructure for running AI agents in production.

Websites have web servers. APIs have application servers. Agents finally have their own.

MUXI Server is a single binary that deploys, manages, and routes to your AI agents. No Kubernetes. No Docker Compose. No nginx. Just muxi-server start and ship.

Important

MUXI Ecosystem

This repository is part of the larger MUXI ecosystem.

📋 Complete architectural overview: See muxi/ARCHITECTURE.md - explains how all 9 repositories fit together, dependencies, status, and roadmap.

---

Quick Start

# Install
curl -fsSL https://muxi.org/install | bash

# Initialize (generates credentials)
muxi-server init

# Start the server
muxi-server start

# Create and deploy a formation
muxi formation new --name=my-agent
cd my-agent
muxi formation deploy

Your agent is live at http://localhost:7890/api/my-agent.

---

How It Works

                 Client Request
                       │
                       ▼
            ┌─────────────────────┐
            │   MUXI Server       │
            │   Port 7890         │
            │                     │
            │  /rpc/*  → Manage   │
            │  /api/*  → Proxy    │
            └──────────┬──────────┘
                       │ routes to
            ┌──────────┼──────────┐
            ▼          ▼          ▼
        agent-1    agent-2    agent-3
       :8001       :8002      :8003
      (localhost only - not exposed)

You deploy formations. The server assigns ports, manages processes, proxies requests, and restarts on crashes. Formations bind to localhost only -- all traffic goes through the server.

---

Features

• One-command deploy -- muxi formation deploy and you're live
• Single binary -- No dependencies, runs on Linux, macOS, and Windows
• Auto-recovery -- Crashed formations restart automatically
• Zero-downtime updates -- Hot swap formations without dropping requests
• Instant rollback -- One command to revert to the previous version
• HMAC authentication -- AWS-style request signing for the management API
• Built-in proxy -- Smart HTTP routing with per-formation isolation
• Telemetry -- Anonymous usage metrics, opt-out with one flag

---

Install

Homebrew:

brew install muxi-ai/tap/muxi

Linux / macOS:

curl -fsSL https://muxi.org/install | bash

Windows:

irm https://muxi.org/install | iex

Docker:

docker run -p 7890:7890 ghcr.io/muxi-ai/server:latest

Manual download: GitHub Releases (Linux, macOS, Windows -- amd64 & arm64)

---

Documentation

Full docs at muxi.org/docs.

Getting Started	Deploy your first formation
Formations	How formations work
API Reference	All 14 HTTP endpoints
Configuration	Server settings
Authentication	HMAC auth setup
Docker Guide	Run in Docker

---

MUXI Ecosystem

MUXI Server is part of the MUXI ecosystem -- a complete stack for building and running AI agents.

Repository	Purpose
muxi	Monorepo, architecture, docs
runtime	Python agent framework
server	Production infrastructure (this repo)
cli	Command-line tool
install	Installation scripts

---

Contributing

See the contributing guide for development setup and guidelines.

• Report a bug
• Request a feature
• Development guide

---

License

Elastic License 2.0 -- free to use, modify, and distribute, including in commercial products. You may not offer MUXI itself as a hosted service.

---

Support

• Docs: muxi.org/docs
• Issues: GitHub Issues
• Community: GitHub Discussions
• Email: support@muxi.org