该存储库目前处于非活动状态,仅作为我们一些论文的补充。我们已经过渡到对新项目使用单独的存储库。对于我们当前的工作,请参阅 Magenta 网站和 Magenta GitHub 组织。
Magenta是一个研究项目,探索机器学习在艺术和音乐创作过程中的作用。这主要涉及开发新的深度学习和强化学习算法来生成歌曲、图像、图画和其他材料。但这也是构建智能工具和界面的探索,使艺术家和音乐家能够使用这些模型扩展(而不是取代!)他们的流程。 Magenta 是由 Google Brain 团队的一些研究人员和工程师发起的,但许多其他人也为该项目做出了重大贡献。我们使用 TensorFlow 并在此 GitHub 上开源发布我们的模型和工具。如果您想了解有关 Magenta 的更多信息,请查看我们的博客,我们在其中发布技术详细信息。您也可以加入我们的讨论组。
这是我们的 Python TensorFlow 库的所在地。要在浏览器中将我们的模型与 TensorFlow.js 一起使用,请前往 Magenta.js 存储库。
查看我们适用于各种型号的 Colab 笔记本,包括入门笔记本。 Magenta.js 也是在浏览器中运行的模型和演示的良好资源。此内容以及更多内容,包括博客文章和 Ableton Live 插件,可以在 https://magenta.tensorflow.org 上找到。
Magenta 维护一个 pip 包以便于安装。我们建议使用 Anaconda 来安装它,但它可以在任何标准 Python 环境中运行。我们支持 Python 3 (>= 3.5)。这些说明假设您使用的是 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 Notebook 中使用,并且 Magenta 脚本安装在您的路径中!
请注意,每次打开新的终端窗口时,您都需要运行source activate magenta
才能使用 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 Notebook 中使用,并且 Magenta 脚本安装在您的路径中!
您现在可以训练我们的各种模型并使用它们来生成音乐、音频和图像。您可以通过浏览模型目录找到每个模型的说明。
如果您想在 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 构建新版本,请更改版本,然后运行:
python setup.py test
python setup.py bdist_wheel --universal
twine upload dist/magenta-N.N.N-py2.py3-none-any.whl