tono

align="center"> <img src="docs/logo.png" width="112" alt="tono — 黑色瓷砖弦波形图"> </p> <p align="center <img src="docs/logo-wordmark.png" width="384" alt="</p> <p align="center"><strong>面向 AI 代理的无头音效工作室 — GarageBand-as MCP。</strong></p> <p align="center"> <a href="https://github.com/marmikshah/tono/actions/workflows/ci.yml"><img src="https://github.com/marmikshah/tono/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://github.com/marmikshah/tono"><img src="https://img.shields.io/github/v/release/marmikshah/tono" alt="发布版本"></ <img src="https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-8c6ee alt="许可证"> </p> <p align="center"> <img src="-flows-spectrogram.png" width="="《River You》的频谱图，，800 个音符p> <p align"> <img src="iver-flows-waveform="320" alt曲的波形图"> <img src="docs/b-waveform.png"320" alt="乐的波形图"> </p> <p align="center"><em>这些图像背后的所有声音 — 一首完整的钢琴曲四乐器的乐三个游戏-ready 的 BGM 环 — 都是通过 MCP 编写、混音和母带制作的，并且每个声音都可以从此存储库中的会话文件中字节相同地重放和文字标志是由 <https://github.com/marmikshah/">atelier</a 的像素艺术兄弟）中的代理绘制的。</em> ## 它是什么 代理擅长 *描述* 不擅长 *听*。tono 弥补了：每个合成器、和混音操作都是渲染都会返回分析 音量、响度谱中心、瞬态 — 以及 **频谱图和波，代理可以直接查看、纠正。就像 DAW 中运行的听修复循环一样。一个进制文件；无需 API 密钥网络，完全确定真正的无头工作室** —核心乐器集琴、电钢琴琴、弦乐、GM 映射、敲击钹、拨弦铜钹色调音台，加上原始的带限振荡器、FM、超锯齿和三种噪声颜色，用于合成和音效。 - **真实录制的乐器** — `sampler` 声音播放任何 SoundFont（指向免费的 GM 银行）：采样的大钢琴、低音、弦乐合奏、GM 鼓。渲染保持确定性。 - **混音 每轨的声益到真正的立体声总线，一个主处理器相关的混响尾，侧链压制，摆动性化节奏。 - **批判的耳朵** — 峰值/真实峰值/RMS/过冲，≈LUFS，频谱中心，攻击减/起始/沉默描述compare_sounds` 听起来对吗？”可以操作的数据。 -性、可重放的 会话文件是有序调用日志；重重现项目 **字节**。注释示例配方教程和 CI 测试 **游戏-ready 输出**/FLAC/OGG，无缝循环和 `sm块，响度软件包和 `sounds 清单，以及 Godot / Unity / Bevy 的引擎完整的工具表面（24）记录在 [docsOLS.md](docs/) 中。 ##设计，播放它，并 除了代理循环同一个确定性引擎驱动更多界面 —SoundDoc`，所有界面都对其进行渲染： - **** — 一个字节相同的媒体渲染器** 和的 `Engine``，因此离线创作的同一个补丁在实时逐块驱动，由游戏发布一个参数化丁](docs/runtime.md渲染无限的实例效变化（一个随着的影响，一个带有表面脚步声），烘焙文件 纯核心直接编译到您的游戏中。 - **可乐器** — 将任何补丁变成多音色高、门控 **，并使用音/关闭、速度、和共享主混。 - **本地** — 一个的 Tauri **像乐器一样补丁**，使用或 MIDI 控制器（ desktop`）。可选 —默认构建、M CI 的一部分。 化游乐场几行 Rust 代码声音或乐器听（`make play`）。 ## 快速入门 ```sh curl -fsSL https://marmikshah.github.io/tono/install.sh | sh ``` 安装程序将 tono 设置为 stdio（您的 MCP 客户端启动它）或作为共享的后台 HTTP 守护进程，并打印行 —aude mcp add --scope user tono`。重新运行它，或附加 `-s -- 以删除。 预编译的二进制文件涵盖 macApple Silicon）、Linux x86_64 和 Windows（从 [releases](https://githubarmikshah//latest) 获取 `.zip`）；其他平台则从构建，执行 `cargo install --path .`。 重启您的会话（MCP 工具启动时加载），您的代理有关声音 —一个有力的激光 zap*"编写一个 的战斗主题"*。循环： ``` author analyze (查看！) → set_param / edit_sound ``` 声音位于 `tono/sounds`（TONO_WORKDIR` — 指向您的游戏资产直接将渲染那里）。 ### 服务器```sh tono # stdio MCP 服务器（默认客户端启动它） http 127.0.1:8787 在 /mcp 上式的 HTTP make # 通过 launchd /user 的后台 HTTP 服务器 真实乐器乐器不需要采样乐器，请免费的 General MIDI SoundFluidR3 GM， GS），并将其：`wave: "sampler", sf2: "/path/to/gm.sf2", sf2_preset: 0`（0 大钢琴，32 低音，48 弦乐；`sf2_bank: 128` = GM 鼓映射）。 ## 会话：确定性、可重放的音乐 每个变异工具调用都会被记录，因此一首音乐作品是一个 **会话文件** — 能够每次重放都相同的 JSON： ```sh tono replay docs/examples/band-demo.json --workdir /tmp/tono-demo ``` 十一份注释示例位于 [docs/examples/](docs/examples/)，每一份都在 CI 中重放。深度切割：规范的 SFX 工作流程（激光 → 变体 → 银行），一个四乐器的乐队在混音台上，完整的 *River Flows in You* 在钢琴乐器上（800 个音符从 MIDI 转换而来，并带有 rubato 和 sustain 踏板 — [docs/examples/midi_to_seq.py](docs/examples/midi_to_seq.py) 转换任意 MIDI），以及三个游戏-ready 的 BGM 音轨 — 一个柔和的傍晚主题，一个激烈的 Boss 战（低音线被击低，弗里吉亚锯齿波导），以及一个摇摆的 idle-platformer 弹跳。 以及一个 **标志性声音包** — 从头开始重建的知名经典，带有 [docs/examples/audio/](docs/examples/audio/) 中的可播放渲染： | 配方 | 播放 | 诀窍 | |---|---|---| | [retro-coin](docs/examples/retro-coin.json) | [▶ mp4](docs/examples/audio/retro-coin.mp4) | B5 优雅音符进入一个保持的 E6 — 间隔 *即为* 声音 | | [jump-8bit](docs/examples/jump-8bit.json) | [▶ mp4](docs/examples/audio/jump-8bit.mp4) | 指数平方扫描，在维持 0 时消失 | | [waka](docs/examples/waka.json) | [▶ mp4](docs/examples/audio/waka.mp4) | 每个音符的音交替上下 — 咀嚼被绘制到音符列表中 | |okia-tune](/nokia-tune | [▶ mp4/examples/audio/nokia.mp4) | Gran Vals 的 13 个音符在 Karplus-Strong上 | |-note](docs/examples/de) | [4](docs/examples/audio/deep-note.mp4) 个超锯音器音轨的集群滑动到一个的大和弦 | 链接直接在 GitHub（每个 mp4 的频谱图作为其轨道 —播放）。OGG 文件4 文件旁边，可。 ## 与 atelier tono 是音频部分的[**atelier**](https://github.com/marmah/atelier)像素艺术的相同 一个无头的 Aseprite-as-API，基于 MCP。并排使用，一个代理会话的艺术 *和频：atelier 、瓷砖；tono 评分环境音和音乐；两者都导出带有清单就绪包，并且两者都记录可重放的配方。 ## 更多 - [docs/TOOLS.md](docs/TOOLS.md) — 完整的 MCP 工具参考。 - [docs/cookbook.md](docs/cookbook.md) — DSL、乐器表和已完成的配方（也作为 `tono://cookbook` 资源提供给代理；其中的每个示例都由测试验证）。 - [ROADMAP.md](ROADMAP.md) — 待办事项。 - ` 构建/测试目标make check` 是门控。 ## 在 [MIT](IT) 或 [.0](LICENSE) 下双重您选择。