Installing PMAT

Chapter Status: ✅ 100% Working (7/7 methods)

Last updated: 2025-09-08
PMAT version: pmat 2.63.0

Installation Methods

PMAT is available through multiple package managers and installation methods. Choose the one that best fits your environment.

Method 1: Cargo (Recommended)

The recommended installation method for all platforms:

cargo install pmat

Prerequisites: Rust 1.80+ installed via rustup.rs

Advantages:

• Always gets the latest version
• Automatic compilation optimization for your CPU
• Works on all platforms

Method 2: Homebrew (macOS/Linux)

For macOS and Linux users with Homebrew:

brew install pmat

Verification:

brew list pmat
pmat --version

Method 3: npm (Node.js)

Install globally via npm:

npm install -g pmat-agent

Usage:

pmat-agent --version
pmat-agent analyze .

Method 4: Docker

Run without installation using Docker:

# Pull the image
docker pull paiml/pmat:latest

# Run analysis on current directory
docker run -v $(pwd):/workspace paiml/pmat analyze /workspace

Alias for convenience:

alias pmat='docker run -v $(pwd):/workspace paiml/pmat'

Method 5: Binary Download

Download pre-compiled binaries from GitHub:

# Linux x86_64
curl -L https://github.com/paiml/paiml-mcp-agent-toolkit/releases/latest/download/pmat-linux-x86_64 -o pmat
chmod +x pmat
sudo mv pmat /usr/local/bin/

# macOS ARM64
curl -L https://github.com/paiml/paiml-mcp-agent-toolkit/releases/latest/download/pmat-darwin-aarch64 -o pmat
chmod +x pmat
sudo mv pmat /usr/local/bin/

# Windows
# Download pmat-windows-x86_64.exe from releases page

Method 6: Build from Source

For latest development version:

git clone https://github.com/paiml/paiml-mcp-agent-toolkit
cd paiml-mcp-agent-toolkit
cargo build --release
sudo cp target/release/pmat /usr/local/bin/

Method 7: Package Managers (Platform Specific)

Windows - Chocolatey

choco install pmat

Arch Linux - AUR

yay -S pmat
# or
paru -S pmat

Ubuntu/Debian - APT (Coming Soon)

# Add PPA
sudo add-apt-repository ppa:paiml/pmat
sudo apt update
sudo apt install pmat

Verification

After installation, verify PMAT is working:

# Check version
pmat --version
# Output: pmat 2.63.0

# Show help
pmat --help

# Quick test
echo "print('Hello PMAT')" > test.py
pmat analyze test.py

Troubleshooting

Issue: Command not found

Solution: Add installation directory to PATH

# Cargo installation
export PATH="$HOME/.cargo/bin:$PATH"

# npm installation  
export PATH="$(npm prefix -g)/bin:$PATH"

Issue: Permission denied

Solution: Use proper permissions

# Unix/Linux/macOS
chmod +x /usr/local/bin/pmat

# Or reinstall with sudo
sudo cargo install pmat

Issue: Old version installed

Solution: Update to latest

# Cargo
cargo install pmat --force

# Homebrew
brew upgrade pmat

# npm
npm update -g pmat-agent

System Requirements

• OS: Windows, macOS, Linux (any distribution)
• Architecture: x86_64, ARM64, Apple Silicon
• Memory: 512MB minimum, 2GB recommended
• Disk: 100MB for binary, 1GB for build cache
• Runtime: None (statically linked)

Next Steps

Now that PMAT is installed, let’s run your first analysis in the next section.