Server › MUXI Documentation

The orchestration platform for AI agents

MUXI Server manages your formations - deploying, routing, monitoring, and auto-restarting them. Think of it as Docker + nginx + PM2 for AI agents.

What It Does

┌─────────────────────────────────────────┐
│ MUXI Server (Port 7890)                 │
│                                         │
│   /rpc/*  → Management API (HMAC auth)  │
│   /api/*  → Formation Proxy             │
│   /health → Health check                │
└────────────────────┬────────────────────┘
                     │
        ┌────────────┼────────────┐
        ↓            ↓            ↓
   ┌─────────┐  ┌─────────┐  ┌─────────┐
   │ Form. A │  │ Form. B │  │ Form. C │
   │  :8001  │  │  :8002  │  │  :8003  │
   └─────────┘  └─────────┘  └─────────┘

Deploy formations with one command
Route requests to the right formation
Authenticate using HMAC signatures
Monitor health and auto-restart on failure
Scale across multiple formations

Quick Start

Install
```
brew install muxi-ai/tap/muxi
```
Initialize
```
muxi-server init
```
Save the generated credentials!
Start
```
muxi-server start
```
Verify
```
curl http://localhost:7890/health
```

Server Commands

Command	Description
`muxi-server init`	Generate config and credentials
`muxi-server start`	Start server (foreground)
`muxi-server serve`	Start server (alias)
`muxi-server status`	Check server status
`muxi-server version`	Show version

Managing Formations

Use the CLI to manage deployed formations:

muxi deploy                    # Deploy a formation
muxi server list            # List all formations
muxi server stop <id>       # Stop a formation
muxi server restart <id>    # Restart a formation
muxi logs --follow             # Stream logs

Key Features

HMAC Authentication

Cryptographically signed requests prevent unauthorized access. Replay-resistant.

Auto-Restart

Crashed formations restart automatically. Configure retry limits and delays.

Health Monitoring

Continuous health checks detect issues. Automatic recovery when problems occur.

Request Routing

Intelligent routing to formations. Proxy handles load and failover.

Configuration Preview

# ~/.muxi/server/config.yaml
server:
  port: 7890
  host: 0.0.0.0

auth:
  enabled: true
  keys:
    - id: MUXI_production
      secret: sk_...

formations:
  port_range: [8000, 9000]
  auto_restart: true