Skip to content

PAM · command-line tools

Audio tools for your AI agent.

Generate samples and measure audio locally with PAM’s command-line tools. Connect through MCP, or build persistent audio workflows with pamd.

The tools come with PAM’s macOS installer for Apple Silicon Macs. Generation and analysis need no licence.

Start with a sound or a file.

  • “Make three short metallic kicks and measure their loudness.” Generation needs downloaded weights and a supported runtime.
  • “Measure the LUFS and true peak of this WAV.” Analysis needs no model.
  • “Load this sample into PAM and build a pattern.” Enable the MCP Bridge under Settings → Integrations in the running PAM instance, then select it through the same server.
pam 1.8.5 · recorded 2026-10-18
$ pam audio generate --prompt "dusty hip hop breakbeat, dry drums, 92 bpm" --seed 7 --duration 5.217391 --category loop --out dusty-breakbeat.wav --json
{  "ok": true,  "sampleRate": 44100,  "seed": 7,  "wavPath": "dusty-breakbeat.wav"}
$ pam audio analyze dusty-breakbeat.wav --json
{  "channels": 2,  "durationSeconds": 5.217392290249433,  "format": "WAV file",  "integratedLufs": -17.51082901429753,  "loudnessRange": 0.9000000000000021,  "ok": true,  "path": "dusty-breakbeat.wav",  "samplePeakDb": -0.9999985473508068,  "sampleRate": 44100,  "truePeakDb": -0.9972471932198774}
Recorded engine log · 2 lines
{"jobId":"01accb45229d4e79a43d1fc7fa2f92eb","progress":0}
{"jobId":"01accb45229d4e79a43d1fc7fa2f92eb","progress":1}
↓ Choose a sound to load it into PAM

Recorded in 33.5 s on Apple M4 Max. Shown faster; file paths shortened.

PAM master—

Your sound. A sampler to make it yours.
Choose a sound above to start the live instrument.

These sounds were generated on a Mac. This page replays the recordings; PAM runs live in your browser.

Connect your agent.

Use a local agent with shell execution or local MCP support. Hosted web and mobile chat cannot execute the binary on your computer. pam mcp gives the agent one pam server, backed by pamd, for files, models and your selected PAM instance. Replace older pam-ai and pam-mcp entries when migrating.

To install the command-line tools, run PAM’s macOS installer from https://map.audio/download, click Customize and tick “Command-Line & AI Agent Tools” (Apple Silicon Macs). Then add PAM to your agent’s MCP configuration:

{
  "mcpServers": {
    "pam": {
      "type": "stdio",
      "command": "/usr/local/bin/pam",
      "args": [
        "mcp"
      ]
    }
  }
}

Inspect the commands available on your machine:

pam version --json
pam manifest --json
pam search "measure loudness"
pam schema audio generate --json
pam audio analyze recording.wav --json

Inspect the resulting file and its measured output, then deliver it through your client’s file tools. A local WAV path alone does not prove an attachment, upload or audition.

Setup, requirements and first success

How the tools work.

pam
Commands and JSON results for local audio tasks, model management and discovery.
pam mcp
The same command contract as MCP tools, with search, describe and run for discovery.
pamd
The persistent local audio service behind agent workflows: retained model workers, job events, cancellation and retrievable results. Only pam starts it.
PAM instrument
Hosts its own models in-process. Authenticated bridge tools edit the instance selected by each agent session.

Inference and measurements run on the computer. Your chosen AI client handles conversations, tool results and shared attachments.

Compare the workflows.

Competitor capabilities below come from publisher documentation and source; they were not independently tested. No overall superiority claim is established. Checked 2026-10-18.

Agent audio interfaces and their documented requirements
Tool / evidenceCLI and discoveryGeneration and analysisEditable session and verificationPersistent jobs and setup
PAMpam 1.8.5Native CLI JSON, manifest/search/schema and MCP from one command contract.Local SA3/Magenta generation and Magenta streaming; WAV loudness and true-peak analysis.One pam MCP server for file/model tools and reading/editing a selected PAM instance. Headless preset render, fx, audio master and dj set require a PAM licence or active trial.Retained model workers, inspectable jobs and cancellation. To install the command-line tools, run PAM’s macOS installer from https://map.audio/download, click Customize and tick “Command-Line & AI Agent Tools” (Apple Silicon Macs). Inference also needs downloaded weights.
Ableton MCP1.4.5 sourceMCP with typed tools; session and capability readers.Creates MIDI content and controls Live devices; no standalone model-job service established by the inspected source.Track, clip and device edits in running Live; state readers and snapshots.Requires Live Remote Script and Python 3.10+. Persistent model jobs not established.
Ableton MCP Pro1.0.0 sourceMCP and musical task skills.MIDI/device workflows, master resampling, a mix-check skill and optional local MIDI melody continuation (midigenai).Arrangement, device, note, locator and warp-marker readers/writers; undo and redo.Live 11+, Python 3.10+; Remote Script or optional Max for Live backend.
Producer Pal2.4.0 device, npm and sourceMCP, portable skill and REST /api/tools with JSON Schemas.Live musical editing; standalone local model inference not established by these docs.Reads and edits Live Sets; documented response errors and warnings.Live 12.3+ and Max for Live; 12.4+ recommended.
Audionautapp 1.6.5 (App Store 1.6.4), MCP 0.4.0; app 1.6.3+ recommendedCLI JSON and MCP wrapper.Audio import/edit, Essentia analysis, Demucs stem separation (downloaded model) and offline export.Current MCP README documents open-project edits, one undo step and host_unavailable failure.Audionaut app plus Node 18+; sandboxed macOS access is restricted to Music.
ReaperMCP0.8.2 source, alphaMCP with project, FX and MIDI tools.LUFS, peaks, clipping, silence and QC with optional analysis dependencies.Project edits, state readers, export, undo and redo.Python 3.10+ and running REAPER Lua bridge; standalone persistent model jobs not established.

Free local models. PAM’s engine when you need it.

Local model generation, streaming and audio analysis are free. Use fx, audio master, preset render and dj set to process files and render presets and DJ sets without opening PAM; they require a PAM licence or active trial.

Model terms apply separately. Stable Audio 3 needs about 2.7 GB of weights; its publisher’s commercial licence has registration and revenue conditions. Model inference requires Apple Silicon and downloaded weights; inspect the installed catalogue for runtime availability.

Powered by Stability AI. Read the model licence.

Get updates by email.

MAP Audio product news, including new pam commands and models.