状态说明

本仓库目前处于非活跃状态（已归档，仅可读），仅作为我们部分论文的补充资料。我们已转向为新项目使用独立仓库。如需了解我们当前的工作，请访问 Magenta 网站 和 Magenta GitHub 组织。

Magenta

Magenta 是一个探索机器学习在艺术和音乐创作过程中作用的研究项目。这主要包括开发新的深度学习和强化学习算法，用于生成歌曲、图像、绘画和其他素材。但同时，它也致力于构建智能工具和界面，使艺术家和音乐家能够利用这些模型来扩展（而非取代！）他们的创作流程。Magenta 最初由 Google Brain 团队 的一些研究人员和工程师发起，但许多其他人也为该项目做出了重要贡献。我们使用 TensorFlow，并在 GitHub 上以开源形式发布我们的模型和工具。如果您想了解更多关于 Magenta 的信息，请查看我们的 博客，我们会在那里发布技术细节。您也可以加入我们的 讨论组。

这里是我们 Python TensorFlow 库的主页。如需在浏览器中通过 TensorFlow.js 使用我们的模型，请访问 Magenta.js 仓库。

快速开始

查看我们的 colab 笔记本，其中包含各种模型，包括一个 入门指南。 Magenta.js 也是一个很好的资源，提供了可在浏览器中运行的模型和 演示。 更多内容，包括 博客文章 和 Ableton Live 插件，可在 https://magenta.tensorflow.org 找到。

Magenta 代码库

• 安装
• 使用 Magenta
• 开发环境（高级）

安装

Magenta 提供了一个 pip 包 以便轻松安装。我们建议使用 Anaconda 进行安装，但它也可在任何标准 Python 环境中运行。我们支持 Python 3（版本 ≥ 3.5）。以下说明将假设您使用的是 Anaconda。

自动安装（使用 Anaconda）

如果您运行的是 Mac OS X 或 Ubuntu 系统，可以尝试使用我们的自动安装脚本。只需将以下命令粘贴到终端中即可。

curl https://raw.githubusercontent.com/tensorflow/magenta/main/magenta/tools/magenta-install.sh > /tmp/magenta-install.sh
bash /tmp/magenta-install.sh

脚本完成后，请打开一个新的终端窗口，使环境变量的更改生效。

现在，Magenta 库可在 Python 程序和 Jupyter 笔记本中使用，并且 Magenta 脚本已安装到你的路径中！

请注意，每次打开新的终端窗口时，你都需要运行 source activate magenta 才能使用 Magenta。

手动安装（不使用 Anaconda）

如果自动化脚本因任何原因失败，或者你希望手动安装，请执行以下步骤。

安装 Magenta 的 pip 包：

pip install magenta

注意：为了安装我们依赖的 rtmidi 包，您可能需要安装一些声音库的头文件。在 Ubuntu Linux 系统上，以下命令可以安装所需的软件包：

sudo apt-get install build-essential libasound2-dev libjack-dev portaudio19-dev

在 Fedora Linux 上，请使用

sudo dnf group install "C Development Tools and Libraries"
sudo dnf install SAASound-devel jack-audio-connection-kit-devel portaudio-devel

Magenta 库现已可在 Python 程序和 Jupyter 笔记本中使用，并且 Magenta 脚本已安装到您的路径中！

使用 Magenta

您现在可以训练我们的各种模型，并使用它们来生成音乐、音频和图像。您可以通过浏览 models directory 找到每个模型的使用说明。

开发环境

如果您想在 Magenta 上进行开发，您需要设置完整的开发环境。

首先，克隆此仓库：

git clone https://github.com/tensorflow/magenta.git

接下来，通过切换到基础目录并执行设置命令来安装依赖项：

pip install -e .

现在，你可以像往常一样通过调用 Python 来编辑文件和运行脚本。例如，以下是从基础目录运行 melody_rnn_generate 脚本的方法：

python magenta/models/melody_rnn/melody_rnn_generate --config=...

您也可以使用以下命令安装（可能已修改的）软件包：

pip install .

在创建拉取请求前，请同样使用以下方式测试您的更改：

pip install pytest-pylint
pytest

PIP 发布

若要为 pip 构建新版本，请更新版本号，然后运行：

python setup.py test
python setup.py bdist_wheel --universal
twine upload dist/magenta-N.N.N-py2.py3-none-any.whl