Installation

Get MUXI running on your system

One command installs both the MUXI Server (orchestration) and CLI (management tool).

Quick Install

# Homebrew handles everything - binaries, PATH, and updates.
brew install muxi-ai/tap/muxi
# System-wide (recommended for servers)
curl -fsSL https://muxi.org/install | sudo bash

# User-level (no sudo required)
curl -fsSL https://muxi.org/install | bash
# Run PowerShell as Administrator for system-wide install.
powershell -c "irm https://muxi.org/install | iex"
docker run -d \
  --name muxi-server \
  -p 7890:7890 \
  -v muxi-data:/data \
  ghcr.io/muxi-ai/server:latest

Verify Installation

muxi --version
muxi-server version

You should see version numbers for both tools.

What Gets Installed

Binary Description Default Port
muxi-server Orchestration server 7890
muxi Command-line tool -

Install Locations

Method Binaries Config
Homebrew /opt/homebrew/bin ~/.muxi/
Linux (sudo) /usr/local/bin /etc/muxi/
Linux (user) ~/.local/bin ~/.muxi/
Windows %LOCALAPPDATA%\MUXI\bin %USERPROFILE%\.muxi\

After Installation

  1. Initialize the server

    muxi-server init

    This generates authentication credentials. Save them - you'll need them for CLI access.

  2. Start the server

    muxi-server start

    Server runs on port 7890.

  3. Create your first formation

    muxi new formation my-assistant
cd my-assistant
muxi secrets setup
muxi dev

See the Quickstart for a complete walkthrough.

Installation Options

Flag Description
--non-interactive Skip prompts, use defaults
--cli-only Install CLI only (no server) 
curl -fsSL https://muxi.org/install | bash -s -- --cli-only

System Requirements

Component Minimum Recommended
CPU 2 cores 4+ cores
RAM 2 GB 8 GB
Disk 10 GB 50 GB SSD

Platform-Specific Guides

macOS

Homebrew, manual install, Apple Silicon notes.

Linux

Ubuntu, Debian, RHEL, systemd service setup.

Windows

PowerShell, WSL options, service configuration.

Docker

Container deployment and Docker Compose.
Home Registry Documentation Star on GitHub
Get priority support