Phantom は、音声を測定し、AI アシスタントのエビデンスを機能させるために提供します。 ミックスやステムのフォルダを分析し、参照とそれを比較し、ラウドネス、トーンバランス、ステレオの動作、フェーズ、および周波数のマスキングを調べます。

コマンドラインツール、Pythonライブラリ、またはMCPサーバーとして使用します。 Claudeコードプラグインは、測定を解釈し、ミックスを計画するための5つのスキルを追加します。 Reaper と Ableton MCP の統合を分離することで、DAW 内でアシスタント作業ができます。

ドキュメンテーション・はじめる・ツール参照・リリース

1つのファイルから始まる

Phantom は macOS と Linux を Python 3.10–3.13 でサポートします。 以下のコマンドは 3.13 を使用します。 Windowsはサポートされていません: Esssentiaの依存性はWindowsの車輪を持っていません。 交換用バックエンドは問題#52で追跡されます。

uvをインストールします。

CLIはAIアシスタントなしで動作します。 まず、MCP サーバーとClaude Code プラグインを構成する設定を実行できます。[phantom setup] を明示的に実行することもできます。

アシスタントのために、「これらの茎を分析します。 技術的な問題を優先し、測定を説明し、何も変更する前にリスニングしてチェックするものを教えてください。

できること

• **混合する前に録音を確認してください.

Phantom

Phantom measures audio and gives an AI assistant evidence to work with. Analyze a mix or a folder of stems, compare it with a reference, and investigate loudness, tonal balance, stereo behavior, phase, and frequency masking.

Use it as a command-line tool, a Python library, or an MCP server. The Claude Code plugin adds five skills for interpreting the measurements and planning a mix. Separate Reaper and Ableton MCP integrations let an assistant work inside your DAW.

Documentation · Getting started · Tool reference · Releases

Start with one file

Phantom supports macOS and Linux with Python 3.11–3.13. The commands below use 3.13. Windows is not supported: the Essentia dependency has no Windows wheel. A replacement backend is tracked in issue #52.

Install uv, then:

uv tool install phantom-audio --python 3.13
phantom analyze mix.wav
phantom analyze mix.wav --json
phantom compare mix.wav --reference reference.wav
phantom doctor

The CLI works without an AI assistant. First use may run setup to configure the MCP server and Claude Code plugin; you can also run phantom setup explicitly.

For an assistant, try: “Analyze these stems. Prioritize technical problems, explain the measurements, and tell me what you would check by listening before changing anything.”

What you can do

• Check a recording before mixing. Look for digital clipping, DC offset, mains hum, noise, and stereo polarity problems. Batch diagnostics also report differing sample rates.
• Compare a mix with a reference. Measure loudness, relative octave-band balance, dynamics, and stereo differences. Nine genre profiles provide starting targets when you do not have a reference file.
• Find competing stems. Rank pairs by weighted octave-band overlap to decide where to investigate masking. The score is a heuristic; it does not establish that one instrument is inaudible.
• Try corrective processing. With the processing extra, apply EQ and other Pedalboard operations or use recipes for selected detected problems. fix_audio reports before/after findings, including regressions.
• Read meters from Phantom Studio. read_live_metrics reads local snapshots from the separate Studio preview plugin. Studio is not included in this package.

The measurements support an engineering decision. They cannot decide whether distortion is intentional, whether a reference suits a song, or whether a change sounds better.

Analysis tools

The MCP server exposes 20 tools over stdio: