hellyee

Claude와 대화하면서 Ableton Live에서 음악을 만드세요 — 실제 미터를 읽어서 믹스하고 마스터링합니다.

다른 AI↔Ableton 브리지는 모델에게 도구 세트를 넘겨줄 뿐입니다. hellyee는 루프를 닫습니다: 실제 출력 레벨을 측정하고, 조정하고, 다시 측정합니다 — 그리고 Claude에게 도구가 무엇을 하는지가 아니라 어떻게 프로듀싱하는지를 가르치는 스킬을 제공합니다. 대화 하나로 작곡, 사운드 디자인, 오토메이션, 어레인지, 믹스, 마스터링까지 완성된 트랙을 만들 수 있습니다.

you  →  "balance the mix — kick on top, then master it"

Claude →  plays the drop · reads every track's meter · adjusts faders ·
          measures again until it converges · loads EQ → Glue → Limiter ·
          drives the limiter by measurement · reports: "peak 0.835,
          breakdown-to-drop dynamic 0.23 — the drop still hits"

기능

총 48개 도구. 전체 레퍼런스는 아래.

다른 도구와 비교

좋은 대안들이 있습니다 — 인정할 것은 인정합니다. hellyee를 차별화하는 것은 닫힌 루프와 스킬 레이어입니다:

가장 검증된 옵션을 원한다면 ahujasid의 것이 가장 널리 사용됩니다. 모델이 트랙을 완성하기를 원한다면 — 오토메이션, 측정된 믹스, 마스터링된 마스터 버스 — 그것이 hellyee의 목적입니다.

작동 방식

Claude는 hellyee를 하위 프로세스로 실행하고 MCP를 통해 통신합니다. hellyee는 Live 자체 Python 안에서 실행되는 원격 스크립트인 AbletonOSC와 OSC로 통신하며, Live 오브젝트 모델을 구동합니다.

기본 AbletonOSC는 많은 것을 노출하지만 브라우저, 마스터 트랙, 어레인지 클립은 노출하지 않습니다. hellyee는 이 세 가지를 모두 추가하는 핸들러와 이를 설치하는 패처를 제공합니다.

설치

1. 설치 프로그램 실행

uv가 있다면 — Python 설정이 전혀 필요 없습니다:

uvx hellyee setup

그렇지 않다면:

pip install hellyee
hellyee setup

curl -LsSf https://astral.sh/uv/install.sh | sh     # macOS · Linux
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"   # Windows

uv는 자체 Python을 다운로드하므로 Python을 설치하거나 관리할 필요가 없습니다.

hellyee setup은 AbletonOSC를 다운로드하고 브라우저 / 마스터 / 어레인지 핸들러로 패치한 다음 Claude 설정을 작성합니다. 멱등적입니다 — 언제든 다시 실행하세요. Claude Desktop은 --client desktop, 둘 다는 --client both를 사용하세요.

오디오 기능(흥얼림→MIDI, 음성 명령)을 원하시나요? 약 380MB가 추가되므로 선택 사항입니다:

pip install "hellyee[audio]"

2. Live 설정

이 단계는 수동입니다 — Live는 자체 컨트롤 서페이스를 활성화하는 API가 없습니다.

1. Live를 종료하고 다시 엽니다. 원격 스크립트는 시작 시에만 스캔됩니다.

2. 설정을 엽니다:

   • Live 12: 설정 → Link, Tempo & MIDI

   • Live 11: 환경설정 → Link/Tempo/MIDI

   • macOS는 Cmd + , · Windows는 Ctrl + ,

3. Control Surface 테이블에서 첫 번째 빈 행에 AbletonOSC를 선택합니다.

4. Input과 Output은 None으로 둡니다 — MIDI 포트가 아닌 네트워크로 통신합니다.

5. Live의 상태 표시줄에 AbletonOSC: Listening for OSC on port 11000이 표시되어야 합니다.

한 번만 하면 됩니다. Live가 기억합니다.

3. 스킬

hellyee setup은 .mcp.json 옆의 .claude/skills/hellyee/에 스킬도 설치합니다. 이 스킬은 Claude에게 이 도구들을 잘 다루는 방법을 가르칩니다 — 순서 규칙, 파라미터 규칙, 측정 방법, 그리고 오류 없이 조용히 실패하는 몇 가지 Live 동작들에 대해 알려줍니다.

Claude Code가 자동으로 인식합니다. 직접 읽어볼 가치가 있습니다: 무엇이 잘못되고 왜 그런지에 대한 압축된 지도입니다.

4. 확인

Live가 열린 상태에서:

hellyee doctor     # connection, handlers, optional features
hellyee smoke      # full end-to-end test, cleans up after itself

smoke는 실제 트랙을 만들고, 노트를 작성하고 퀀타이즈하며, 악기를 로드한 다음 트랙을 삭제합니다. --keep를 전달하면 그대로 둡니다.

사용법

원하는 것을 말하세요. Claude가 세트 상태를 먼저 읽은 다음 행동합니다.

"make a 4-bar house beat at 124 BPM"
"add a MIDI track called Bass and put Wavetable on it"
"write a rolling bassline in F minor, offbeat eighths"
"quantize that to 16ths at 0.7 strength so it still breathes"
"put an Auto Filter on the bass and close it down a bit"
"this lead is harsh — round off the highs and slow the attack"
"balance the mix, kick should sit on top"
"arrange this into a full track: intro, build, drop, breakdown, drop, outro"
"sweep the filter open across the last 8 bars before the drop"

알아두면 좋은 규칙

시간은 비트 단위입니다. 4/4 한 마디는 4비트이고, 16분음표는 0.25입니다.

피치는 Live 표시 규칙을 따릅니다: C3 = 60. 표준 MIDI 표기법에서는 이를 C4라고 부릅니다. hellyee는 Live를 따르므로 Claude가 작성한 노트가 화면에 보이는 노트와 일치합니다.

디바이스 파라미터는 단위가 아닌 퍼센트로 설정합니다. Live의 원시 값은 UI에 표시되는 것과 다른 내부 스케일에 있습니다 — Auto Filter의 Frequency는 20–135 범위지만 "265 Hz"로 표시됩니다. 파라미터는 percent(파라미터 자체 범위의 0–100)로 설정하세요. 도구는 실제로发生了什么 일어났는지 확인할 수 있도록 표시된 값을 보고합니다.

도구

오디오 입력

Claude의 API는 오디오를 받지 않으므로 오디오는 로컬에서 처리되고 텍스트 또는 JSON으로 모델에 전달됩니다:

notes_from_audio는 모노포닉 전용입니다 — 흥얼거림, 단선 멜로디. 코드나 전체 믹스는 전사하지 않습니다. 그런 용도에는 basic-pitch 같은 폴리포닉 모델을 사용하세요.

Apple Silicon에서는 pip install mlx-whisper로 전사가 훨씬 빨라집니다. hellyee는 설치되어 있으면 이를 우선 사용합니다. 첫 실행 시 모델(~500MB)을 다운로드합니다.

알려진 제한 사항

Claude는 들을 수 없습니다. Live의 미터를 통해 출력 레벨을 측정하고 주파수 범위에 대해 추론할 수는 있지만, 톤을 판단할 수는 없습니다. EQ와 사운드 디자인 선택은 관례와 측정에서 비롯됩니다. 최종 판단은 여러분의 귀에 달려 있습니다.

서드파티 플러그인은 불투명합니다. Live는 VST/AU 파라미터를 수동으로 노출하기 전까지 API에 노출하지 않습니다. Serum, Vital 등은 로드되고 재생되지만, Claude는 Device On이라는 하나의 파라미터만 볼 수 있습니다. 플러그인을 잠금 해제하려면 디바이스 헤더에서 Configure를 누르고, 제어하려는 노브를 클릭한 다음 Configure를 종료하면 해당 파라미터가 나타납니다.

미터링은 약 10Hz로 실행됩니다. AbletonOSC는 100ms 틱으로 처리되므로, 미터는 일시적인 피크가 아닌 지속 레벨을 측정합니다.

퀀타이즈는 클라이언트 측에서 수행됩니다. 노트를 읽고, Python에서 스냅하고, 다시 기록합니다. 이것이 strength가 존재하는 이유입니다. 하지만 즉시 처리되는 대신 왕복 비용이 발생합니다.

오토메이션은 세션 클립에서 시작해야 합니다. Live는 세션 클립에서만 엔벨로프를 생성하므로, hellyee는 오토메이션을 세션 클립에 작성하고 클립이 배치될 때 어레인지먼트로 가져옵니다. 섹션별로 오토메이션을 다르게 하려면 여러 클립 변형을 작성하고 각 섹션에 적절한 것을 배치하세요.

세션 클립은 어레인지먼트를 재정의합니다. 트랙에서 세션 클립이 한 번이라도 실행된 적이 있으면, Back to Arrangement를 누를 때까지 어레인지먼트 클립을 무시합니다. hellyee가 이를 처리하지만, 무언가가 조용히 재생될 때 알아두는 것이 좋습니다.

실행 취소 그룹화가 없습니다. 각 작업은 Live의 실행 취소 기록에서 별도의 단계입니다.

개발

hellyee/
  osc.py            OSC client — persistent socket, request/response matching
  core.py           Live operations as plain functions (no Claude dependency)
  music.py          scales, chords, quantization, key-aware spelling
  audio.py          audio → notes, speech → text
  mcp_server.py     MCP tool layer
  cli.py            connection tests and diagnostics
abletonosc_patch/
  browser.py        adds browser access to AbletonOSC
  master.py         adds master track + arrangement to AbletonOSC
  setup_cli.py      installer: download, patch, configure Claude
abletonosc_patch/
  → shipped inside the wheel as hellyee/_patch
.claude/skills/hellyee/
  SKILL.md          how to drive the tools; loaded by Claude Code

hellyee 자체를 작업할 때:

git clone https://github.com/guvense/hellyee.git && cd hellyee
uv sync --extra audio          # or: pip install -e ".[audio]"
hellyee setup                  # re-applies the patch from your working copy

core.py는 로직을 담고 있으며 Claude에 대해 알지 못하므로, 단독으로 테스트할 수 있고 모든 프런트엔드에서 구동할 수 있습니다. mcp_server.py는 그 위에 있는 얇은 도구 정의 계층입니다.

⚠️ abletonosc_patch/의 파일을 편집하고 있나요? 해당 파일은 Python 3.7을 내장한 Live 내부에서 실행됩니다. 월러스 연산자(:=), 내장 제네릭(list[str]), X | Y 유니온은 파싱되지 않습니다. 패처는 이를 확인해 주지 않지만, python -c "import ast; ast.parse(open('file').read(), feature_version=(3,7))"는 확인해 줍니다.

핫 리로드. 이미 로드된 핸들러를 편집할 때는 Live를 재시작할 필요가 없습니다. /live/api/reload를 보내면 몇 초 안에 변경 사항을 반영합니다. 새 모듈을 추가할 때는 재시작이 필요하며, 이것이 브라우저와 마스터 핸들러가 각각 하나의 파일에 있는 이유입니다.

기여

이슈와 풀 리퀘스트를 환영합니다. 유용한 방향:

• 폴리포닉 오디오-투-MIDI (basic-pitch)

• 리턴 트랙과 센드

• Windows 테스트 (macOS에서 개발됨)

• 스킬용 장르 템플릿과 어레인지먼트 패턴

크레딧

Daniel Jones의 AbletonOSC를 기반으로 제작되었으며, 이는 Live의 Object Model을 OSC로 노출하는 어려운 작업을 수행합니다.

라이선스

MIT

hellyee