Phantom은 오디오를 측정하고 AI 보조 증거를 제공합니다. 줄기의 믹스 또는 폴더를 분석하고 참조와 비교하고, 확성, 톤 균형, 스테레오 행동, 단계 및 주파수 마스킹을 조사합니다.

명령줄 도구, Python 라이브러리 또는 MCP 서버로 사용하십시오. Claude Code 플러그인은 측정을 해석하고 혼합을 계획하는 다섯 가지 기술을 추가합니다. 별도의 레퍼런스와 ABLETON MCP 통합은 DAW 내부의 보조 작업을 할 수 있습니다.

문서 · 시작 · 도구 참조 · 릴리즈

한 파일로 시작

Phantom은 macOS와 Linux를 Python 3.10–3.13으로 지원합니다. 아래 명령은 3.13을 사용합니다. ** Windows는 지원되지 않습니다 : ** Essentia 의존성은 Windows 휠이 없습니다. 교체 백엔드는 문제 #52에 추적됩니다.

uv를 설치, 다음:

CLI는 AI 조수없이 작동합니다. 첫 번째 사용은 MCP 서버와 Claude 코드 플러그인을 구성하기 위해 설정 실행할 수 있습니다. 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: