Setup

npm (Recommended)

Install globally from the npm registry:

npm install -g @thelogicatelier/muxa

Then create a .env file in your working directory with at least one provider key:

# Required: set your primary provider
MUXA_PRIMARY_PROVIDER=openai

# Provide the API key for your chosen provider
OPENAI_API_KEY=sk-your-key
# Or use another provider:
# ANTHROPIC_API_KEY=sk-ant-your-key
# OPENROUTER_API_KEY=sk-or-your-key
# OLLAMA_BASE_URL=http://localhost:11434

Start the proxy:

muxa                  # proxy listens on http://localhost:8081

Or run instantly without installing:

npx @thelogicatelier/muxa

From Source

git clone https://github.com/achatt89/muxa.git
cd muxa
npm install
cp .env.example .env  # fill in OPENAI_API_KEY, OPENROUTER_API_KEY, etc.
npm start             # proxy listens on http://localhost:8081

Docker

Pass your provider API key and primary provider as environment variables. The example below uses OpenAI, but you can substitute any supported provider (Anthropic, OpenRouter, Ollama, Databricks, Azure, etc.):

docker build -t muxa .
docker run --rm -p 8081:8081 \
  -e MUXA_PRIMARY_PROVIDER=openai \
  -e OPENAI_API_KEY=sk-your-key \
  muxa:latest

Homebrew (macOS)

brew tap thelogicatelier/muxa https://github.com/achatt89/muxa.git
brew install muxa
muxa --help

Configuration Cheatsheet