GuitarML NeuralPi 项目下载与安装教程

1. 项目介绍

GuitarML NeuralPi 是一个开源项目，它利用神经网络在 Raspberry Pi 4 上模拟真实的吉他放大器和效果器。这个项目包含一个基于 JUCE 构建的 VST3 插件，可以作为一个标准的音频插件使用，也可以交叉编译在 Raspberry Pi 4 上配合 Elk Audio OS 使用。NeuralPi 支持模型选择、均衡器以及通过 WiFi 从远程插件实例控制的增益/音量控制。

2. 项目下载位置

项目托管在 GitHub 上，可以通过以下地址进行克隆或下载：

https://github.com/GuitarML/NeuralPi.git

3. 项目安装环境配置

在安装前，确保您的 Raspberry Pi 4 已经安装了 Elk Audio OS，并且满足以下要求：

• Raspberry Pi 4B
• HiFiBerry DAC + ADC
• Elk Audio OS

以下为环境配置的步骤示例：

图中展示了 Raspberry Pi 连接 HiFiBerry DAC + ADC 的示例。

4. 项目安装方式

克隆项目

首先，在您的 Raspberry Pi 上打开终端，使用以下命令克隆项目：

git clone https://github.com/GuitarML/NeuralPi.git

编译项目

克隆完成后，进入项目目录，并按照以下步骤编译项目：

cd NeuralPi
mkdir build
cd build
cmake ..
make

编译完成后，将会生成相应的可执行文件。

5. 项目处理脚本

项目中的 scripts 目录包含了用于更新模型的脚本文件。以下为使用这些脚本的示例：

Windows 系统

在远程计算机上运行 update_models.bat 脚本，并确保修改了 Raspberry Pi 的 IP 地址以及模型文件路径。

update_models.bat

Mac/Linux 系统

在远程计算机上运行 update_models.sh 脚本，同样需要修改 Raspberry Pi 的 IP 地址和模型文件路径。

chmod +x update_models.sh
./update_models.sh

以上脚本将帮助您在 Raspberry Pi 和远程计算机之间同步模型文件。

请根据上述步骤操作，您应该能够成功下载和安装 GuitarML NeuralPi 项目。