AccoMontage2 使用教程

AccoMontage2 使用教程

AccoMontage2 项目地址: https://gitcode.com/gh_mirrors/ac/accomontage2

1. 项目目录结构及介绍

AccoMontage2 是一个开源项目，它能够根据给定的旋律生成完整的歌曲和声与伴奏。项目的目录结构如下：

AccoMontage2/
├── .idea
├── MIDI demos/
│   ├── inputs/
│   └── outputs/
├── back-end/
│   ├── app.py
│   └── requirements.txt
├── chorderator/
│   ├── __init__.py
│   ├── core.py
│   ├── static/
│   └── ...
├── colab-notebooks/
├── demo.py
├── docs/
├── front-end/
├── .gitignore
├── LICENSE
├── requirements.txt
└── README.md

• .idea：包含 IDE 的配置文件。
• MIDI demos：存储输入和输出的 MIDI 文件。
• back-end：后端代码，包含 Flask 应用的启动文件 app.py 和依赖文件 requirements.txt。
• chorderator：核心代码库，包含生成和声和伴奏的逻辑。
• colab-notebooks：用于 Colab 的笔记本文件。
• demo.py：演示脚本，用于展示如何使用 chorderator 库。
• docs：文档目录。
• front-end：前端代码。
• .gitignore：Git 忽略文件列表。
• LICENSE：项目许可证文件。
• requirements.txt：项目依赖文件。
• README.md：项目说明文件。

2. 项目的启动文件介绍

项目的启动文件主要是 demo.py 和 back-end/app.py。

• demo.py：这是一个简单的演示脚本，用于展示如何使用 chorderator 库来生成和声和伴奏。它通过设置旋律路径、元数据、分段信息、纹理偏好、音符偏移和输出样式来生成结果，并将结果保存到指定的文件夹。

  示例代码：

  import chorderator as cdt
  if __name__ == '__main__':
      demo_name = 'hpps65'
      input_melody_path = f'MIDI demos/inputs/{demo_name}/melody.mid'
      cdt.set_melody(input_melody_path)
      # ...其他设置...
      cdt.generate_save(demo_name + '_output_results')
  

• back-end/app.py：这是后端 Flask 应用的启动文件。它启动一个 Web 服务器，提供 GUI 界面，用户可以通过该界面上传旋律文件并获取和声和伴奏的生成结果。

  示例代码：

  from flask import Flask
  app = Flask(__name__)
  # ...其他设置和路由...
  if __name__ == '__main__':
      app.run()
  

3. 项目的配置文件介绍

项目的配置文件主要包括 requirements.txt 和 .gitignore。

• requirements.txt：该文件列出了项目运行所需的 Python 包依赖。使用以下命令安装依赖：

  pip install -r requirements.txt
  

• .gitignore：该文件指定了 Git 应该忽略的文件和目录列表，以避免将不必要的文件提交到仓库中。例如，IDE 的配置文件、日志文件和虚拟环境目录通常会被忽略。

以上就是 AccoMontage2 的使用教程，希望对您有所帮助。

AccoMontage2 项目地址: https://gitcode.com/gh_mirrors/ac/accomontage2