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 通过 OSC 与 AbletonOSC 通信，AbletonOSC 是运行在 Live 自身 Python 中的远程脚本，驱动 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 配置。它是幂等的——随时可以再次运行。使用 --client desktop 用于 Claude Desktop，或 --client both。

想要音频功能（哼唱转 MIDI、语音命令）？它们会增加约 380 MB，所以是可选安装：

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. 在控制表面表中，选择第一行空闲的 AbletonOSC。

4. 将输入和输出保持为 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 拍；一个十六分音符是 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 在存在时会优先使用它。首次运行会下载一个模型（约 500 MB）。

已知限制

Claude не слышит. Он может измерять уровни выходного сигнала через измерители Live и рассуждать о частотных диапазонах, но не может оценить тембр. Выбор эквалайзера и звукового дизайна основан на условностях и измерениях — окончательное решение за вашими ушами.

Сторонние плагины непрозрачны. Live не предоставляет параметры VST/AU в API, пока вы не откроете их вручную. Serum, Vital и другие загрузятся и будут играть, но Claude видит только один параметр: Device On. Чтобы разблокировать плагин, нажмите Configure в заголовке устройства, щелкните по ручкам, которые вы хотите сделать управляемыми, затем выйдите из Configure — эти параметры появятся.

Измерение работает с частотой ~10 Гц. AbletonOSC обрабатывает данные с тактом 100 мс, поэтому измерители измеряют устойчивый уровень, а не пиковые значения.

Квантизация выполняется на стороне клиента. Ноты считываются, выравниваются в Python и записываются обратно. Именно поэтому существует strength — но это требует дополнительного цикла, а не происходит мгновенно.

Автоматизация должна начинаться в сессионном клипе. Live создает огибающие только на сессионных клипах, поэтому hellyee записывает автоматизацию там и переносит ее в аранжировку при размещении клипа. Чтобы варьировать автоматизацию по секциям, создайте несколько вариантов клипа и разместите нужный в каждой.

Сессионные клипы переопределяют аранжировку. Если на дорожке когда-либо запускался сессионный клип, она игнорирует клипы аранжировки, пока не будет нажата кнопка Back to Arrangement. hellyee обрабатывает это, но полезно знать, когда что-то играет молча.

Нет группировки отмены. Каждая операция является отдельным шагом в истории отмены Live.

Development

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/? Эти файлы работают внутри Live, который включает Python 3.7. Моржовые операторы (:=), встроенные дженерики (list[str]) и объединения X | Y не будут парситься. Патчер не проверяет это за вас — но python -c "import ast; ast.parse(open('file').read(), feature_version=(3,7))" проверяет.

Горячая перезагрузка. Редактирование уже загруженного обработчика не требует перезапуска Live — отправьте /live/api/reload, и изменения подхватятся за секунды. Добавление нового модуля требует перезапуска, поэтому обработчики браузера и мастера каждый живут в одном файле.

Contributing

Приветствуются issues и pull requests. Полезные направления:

• Полифоническое преобразование аудио в MIDI (basic-pitch)

• Возвратные дорожки и sends

• Тестирование на Windows (разработано на macOS)

• Шаблоны жанров и паттерны аранжировки для навыка

Credits

Создано на основе AbletonOSC Дэниела Джонса, который выполняет тяжелую работу по предоставлению объектной модели Live через OSC.

License

MIT

hellyee