音樂經紀人

音樂代理商使用手冊

目錄

1. 介紹
2. 它是如何運作的？
3. 使用音樂代理
   • 先決條件
   • 安裝
4. 配置
5. 運行 MusicAgent
   • 網頁應用程式
   • 命令列介面
6. 輸出
7. 示範
8. 關於

---

介紹

MusicAgent 是一個 MAS（多代理系統），用於在 Sonic Pi 中編程歌曲。它使用生成式人工智慧根據使用者偏好生成歌曲結構、編曲、歌詞…。本手冊提供有關安裝、配置和歌曲生成的說明。它尚未產生歌聲（您可以使用樣本包含它們，僅使用樂器版本。

它是如何運作的？

觀看音樂經紀人的實際操作

我們定義了不同的助手，他們在歌曲的創作和創作階段扮演不同的角色。將從使用者的初始輸入開始處理不同的步驟。

不同的助理角色：ArtistConfig.json 中定義了不同的角色

• 藝術家
• 作曲家
• 作曲家
• 編曲者
• Sonic PI 編碼器
• 索尼克 PI 審稿人
• Sonic PI 混音工程師
• 碩士工程師
• 音樂出版商

所有角色都參與歌曲創作的不同階段。

• 鏈中序列的配置可以在 MusicCreationChainConfig.json 中找到。
• 每個階段的配置和描述在 MusicCreationPhaseConfig.json 中配置。

1. 設計階段

2. 創建階段

sonic pi 腳本的實際建立、初始播放、迭代代理或人工審核，然後進行程式碼重寫。

3. 掌握階段

4. 發布階段

根據藝術家配置，包括 sonic pi 腳本檔案生成、專輯封面、小冊子和可選的歌曲錄製。

最終的產出是一本帶有專輯封面的小冊子（根據所選配置，也可以是錄音），當然還有 *.rb 檔案中的編碼歌曲。

使用音樂代理

先決條件

• Sonic Pi：必須安裝在您的系統上（需要執行 *.rb 檔案）：https://sonic-pi.net/
• Python必須安裝在你的機器上

模型API

音樂代理商與 OpenAI 和 Anthropic API 配合得很好（Anthropic 目前不提供圖像生成，因此不會生成專輯封面）。若要在兩者之間切換，請確保在設定檔或環境變數中設定這兩個變數。

• OPENAI_API_KEY：設定為系統環境變數或在ArtistConfig/mITyJohn/ArtistConfig.json 。

  在 MAC 上：

   export OPENAI_API_KEY= '  '

  在 Windows 上（使用 PowerShell）：

   $env :OPENAI_API_KEY= '  '

• ANTHROPIC_API_KEY：設定為系統環境變數或在ArtistConfig/mITyJohn/ArtistConfig.json 。

  在 MAC 上：

   export ANTHROPIC_API_KEY= '  '

  在 Windows 上（使用 PowerShell）：

   $env :ANTHROPIC_API_KEY= '  '

安裝

 # Clone the repository
git clone [repository link]

# Install dependencies
pip install -r requirements.txt

由於人為依賴性，您還需要安裝 RUST：https://www.rust-lang.org/tools/install

配置

如果未設定為系統變量，請在ArtistConfig/mITyJohn/ArtistConfig.json中設定OPENAI_API_KEY 。根據需要調整 ArtistConfig.json 中的設定。

預設情況下，藝術家 mITyJohn 將運行音樂創作的基本鏈。但如果您想要額外的 sonic pi 評估或甚至開始錄音，您可以選擇其他代理配置=

• Eval：將透過在您的電腦上執行的 sonic pi 實例評估您的 sonic pi 程式碼
• 完整：將透過在您的電腦上執行的 sonic pi 執行個體評估您的 sonic pi 程式碼，但也會開始錄製（目前僅在 Windows 電腦上）
• 藝術：根據藝術家配置限制專輯封面生成（無歌曲生成）

對於這些擴展鏈，需要額外的設定：

1. 在您的電腦上啟動 Sonic Pi
2. 調整 ArtistConfig.json 並修正 sonic_pi_IP 和 sonic_pi_port（這些可以透過選單 > IO 在 Soni Pi IDE 中找到）。驗證是否允許傳入 OSC 訊息。
3. 複製並運行以下程式碼（需要在啟動 MusicAgent 之前運行）

e osc_send '127.0.0.1', 4559, '/feedback', e.message end end">

live_loop :listen do
  use_real_time
  script = sync " /osc*/run-code "
  
  begin
    eval script[0]
    osc_send ' 127.0.0.1 ' , 4559, ' /feedback ' , ' MusicAgent Code was executed successfully '
  rescue Exception = > e
    osc_send ' 127.0.0.1 ' , 4559, ' /feedback ' , e.message
  end
end

或直接在您的 Sonic PI 中載入Sonicpi/Setup/recording.rb 。

4. 啟動後，您會注意到 Cues 中的偵聽器正在啟動。這將使 Sonic Pi 能夠播放您的音樂檔案並向 MusicAgent 發送回饋。

運行 MusicAgent

MusicAgent 可以透過 2 種不同的方式運作：透過 CLI 或透過 Web 應用程式。

網頁應用程式

運行 Web 應用程式將允許您透過 Web 介面與 MusicAgent 互動。

python app.py

該應用程式可視化音樂創作過程的不同階段，並允許您與 MusicAgent 互動。您也可以與不同的代理商進行聊天對話。

此外，您還可以查看不同的 Sonic Pi 版本，甚至將它們傳送到 Sonic PI IDE。

有關如何使用 Music Agent Web 應用程式的更多詳細信息，請參閱 Music Agent 應用程式自述文件

命令列介面

運行 CLI 將允許您透過命令列與 MusicAgent 互動。

python run.py

啟動後，您將能夠通過多個標準：

• 出現提示時選擇 AI 模型：「gpt-3.5-turbo」、「gpt-4」等。
• 提供歌曲詳細資訊：名稱、時長、風格
• 可以選擇新增特定請求，例如和弦進行或音樂影響。

Sonic PI 範例可以在「SonicPi/Examples」資料夾中找到。

輸出

MusicAgent 將在歌曲資料夾中由曲目名稱呼叫的子目錄中產生以下內容：

• 產生的曲目檔案： *.rb 檔案可以在 Songs 目錄中找到。要播放您的曲目，只需將檔案載入到 SONIC PI 中即可。
  • 當使用「完整藝術家」配置時，將另外建立錄音 WAV 檔案（無需隨後將其載入到 sonic Pi 中）
• 包含封面圖片（位於同一子目錄中）、歌詞和其他有關曲目設定的技術資訊的小冊子
• 音樂代理日誌檔。如果追蹤代碼遺失或不完整，您可以驗證日誌。

如果您在執行代理程式時使用 mITyJohn_Full 配置，且您的錄音裝置已正確配置（目前僅在 Windows 上），則會自動進行錄音。

關於

Music Agent 最初由 mITyJohn 開發。該專案是開源的，可在 GitHub 上供社群貢獻和改進（只是因為它很有趣！）。